Funktionreferenz


_GUICtrlListView_GetNextItem

Beschreibung anzeigen in

Sucht nach einem Item, welches die festgelegten Eigenschaften aufweist

#include <GuiListView.au3>
_GUICtrlListView_GetNextItem ( $hWnd [, $iStart = -1 [, $iSearch = 0 [, $iState = 8]]] )

Parameter

$hWnd Control-ID / Handle des Controls
$iStart [optional] Index des Items bei dem die Suche begonnen werden soll oder -1 um das erste Item zu finden, welches die festgelegten Flags aufweist. Das festgelegte Item wird dabei von der Suche ausgeschlossen.
$iSearch [optional] Beziehung zum Index des Items wo die Suche beginnen soll:
    0 - Sucht nach einem folgenden Item durch einen Index
    1 - Sucht nach einem Item welches über dem festgelegten Item steht
    2 - Sucht nach einem Item welches unter dem festgelegten Item steht
    3 - Sucht nach einem Item welches links von dem festgelegten Item steht
    4 - Sucht nach einem Item welches rechts von dem festgelegten Item steht
$iState [optional] Status des Item. Kann eine Kombination der folgenden sein:
    1 - Das Item ist ausgeschnitten
    2 - Das Item ist hervorgeheben
    4 - Das Item ist fokusiert
    8 - Das Item ist markiert

Rückgabewert

Erfolg: Der 0-basierende Index des nächsten Items
Fehler: -1

Bemerkungen

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

Beispiel

#include <GUIConstantsEx.au3>
#include <GuiListView.au3>
#include <MsgBoxConstants.au3>

Example()

Func Example()
    Local $idListView

    GUICreate("ListView: Nächstes Item ermitteln", 400, 300)
    $idListView = GUICtrlCreateListView("", 2, 2, 394, 268)
    GUISetState(@SW_SHOW)

    ; Fügt die Spalten hinzu
    _GUICtrlListView_AddColumn($idListView, "Items", 100)

    ; Fügt die Items hinzu
    _GUICtrlListView_AddItem($idListView, "Item 1")
    _GUICtrlListView_AddItem($idListView, "Item 2")
    _GUICtrlListView_AddItem($idListView, "Item 3")

    ; Wählt Item 2 aus
    _GUICtrlListView_SetItemSelected($idListView, 1)

    ; Ausgewähltes Item finden
    MsgBox($MB_SYSTEMMODAL, "Information", "Ausgewähltes Item: " & _GUICtrlListView_GetNextItem($idListView))

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