Funktionreferenz


_GUICtrlTreeView_AddFirst

Beschreibung anzeigen in

Fügt ein neues Item am Anfang hinzu

#include <GuiTreeView.au3>
_GUICtrlTreeView_AddFirst ( $hWnd, $hSibling, $sText [, $iImage = -1 [, $iSelImage = -1]] )

Parameter

$hWnd Control-ID / Handle des Controls
$hSibling Item auf gleicher Ebene
$sText Text des Items
$iImage [optional] 0-basierender Index des Item Icons in der Imagelist des Controls
$iSelImage [optional] 0-basierender Index des Item Icons in der Imagelist des Controls

Rückgabewert

Erfolg: Das Handle zum neuen Item
Fehler: 0

Bemerkungen

Das Item wird als erstes Item auf gleicher Ebene zu $hSibling hinzugefügt. Items die nach dem hinzugefügten Item erscheinen wandern einen Platz nach unten.

- - - - - - - - Erklärung der Controls - - - - - - - -

Verwandte Funktionen

_GUICtrlTreeView_Add

Beispiel

#include <GuiConstantsEx.au3>
#include <GuiTreeView.au3>
#include <WindowsConstants.au3>

Example()

Func Example()
    GUICreate("TreeView: Neues Item am Anfang hinzufügen (v" & @AutoItVersion & ")", 500, 300)

    Local $iStyle = BitOR($TVS_EDITLABELS, $TVS_HASBUTTONS, $TVS_HASLINES, $TVS_LINESATROOT, $TVS_DISABLEDRAGDROP, $TVS_SHOWSELALWAYS, $TVS_CHECKBOXES)
    Local $idTreeView = GUICtrlCreateTreeView(2, 2, 396, 268, $iStyle, $WS_EX_CLIENTEDGE)
    GUISetState(@SW_SHOW)

    _GUICtrlTreeView_BeginUpdate($idTreeView)
    Local $hItem
    For $x = 1 To Random(2, 10, 1)
        $ahItem = _GUICtrlTreeView_Add($idTreeView, 0, StringFormat("[%02d] Neues Item", $x))
        For $y = 1 To Random(2, 10, 1)
            _GUICtrlTreeView_AddChild($idTreeView, $ahItem, StringFormat("[%02d] Neues Child", $y))
        Next
    Next
    _GUICtrlTreeView_AddFirst($idTreeView, $ahItem, "[00] Neues erstes Item")
    _GUICtrlTreeView_EndUpdate($idTreeView)

    ; Die Schleife wiederholt sich, bis der Benutzer die Beenden-Aktion der GUI auslöst.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
    GUIDelete()
EndFunc   ;==>Example