LVM_GETNEXTITEMINDEX Nachricht
Ruft den Index eines Elements in einem angegebenen Listenansichtssteuerelement ab, das den angegebenen Eigenschaften und der Beziehung zu einem anderen Element entspricht. Senden Sie diese Nachricht explizit oder mithilfe des Makros ListView_GetNextItemIndex .
Parameter
-
wParam [in, out]
-
Ein Zeiger auf die LVITEMINDEX-Struktur für das Element, mit dem die Suche gestartet werden soll, oder -1, um das erste Element zu finden, das den angegebenen Flags entspricht. Der aufrufende Prozess ist für die Zuweisung dieser Struktur und das Festlegen ihrer Member verantwortlich.
-
lParam
-
Gibt die Beziehung zu dem im Parameter wParam aufgeführten Element an. Dies kann ein oder eine Kombination der folgenden Werte sein:
Wert Bedeutung - Sucht nach Index.
- LVNI_ALL
Sucht nach einem nachfolgenden Element nach Index, dem Standardwert. - Sucht nach physischer Beziehung zum Index des Elements, in dem die Suche beginnen soll.
- LVNI_ABOVE
Sucht nach einem Element, das sich oberhalb des angegebenen Elements befindet. - LVNI_BELOW
Sucht nach einem Element, das sich unterhalb des angegebenen Elements befindet. - LVNI_TOLEFT
Sucht links neben dem angegebenen Element nach einem Element. - LVNI_PREVIOUS
Windows Vista und höher: Sucht nach einem Element, das vor dem in wParam angegebenen Element sortiert ist. Das LVNI_PREVIOUS-Flag ist nicht richtungsspezifisch (LVNI_ABOVE findet den oben positionierten Artikel, während LVNI_PREVIOUS den zuvor bestellten Artikel finden.) Das LVNI_PREVIOUS-Flag kehrt die Logik der Suche, die von den LVM_GETNEXTITEM- oder LVM_GETNEXTITEMINDEX-Nachrichten ausgeführt wird, im Grunde um. - LVNI_TORIGHT
Sucht rechts neben dem angegebenen Element nach einem Element. - LVNI_DIRECTIONMASK
Windows Vista und höher: Ein direktionales Flagformat mit folgendem Wert: LVNI_ABOVE | LVNI_BELOW | LVNI_TOLEFT | LVNI_TORIGHT. - Der Status des zu findenden Elements kann mit einem oder einer Kombination der folgenden Werte angegeben werden:
- LVNI_CUT
Für das Element ist das LVIS_CUT Statusflag festgelegt. - LVNI_DROPHILITED
Für das Element ist das LVIS_DROPHILITED-Statusflag festgelegt. - LVNI_FOCUSED
Für das Element ist das LVIS_FOCUSED Statusflag festgelegt. - LVNI_SELECTED
Für das Element ist das LVIS_SELECTED Statusflag festgelegt. - LVNI_STATEMASK
Windows Vista und höher: Eine Statusflagsmaske mit folgendem Wert: LVNI_FOCUSED | LVNI_SELECTED | LVNI_CUT | LVNI_DROPHILITED. - Sucht nach Darstellung von Elementen oder nach Gruppe.
- LVNI_VISIBLEORDER
Windows Vista und höher: Suchen Sie die sichtbare Reihenfolge. - LVNI_VISIBLEONLY
Windows Vista und höher: Suchen Sie die sichtbaren Elemente. - LVNI_SAMEGROUPONLY
Windows Vista und höher: Durchsuchen Sie die aktuelle Gruppe. - Wenn für ein Element nicht alle angegebenen Statusflags festgelegt sind, wird die Suche mit dem nächsten Element fortgesetzt.
Rückgabewert
Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE .
Bemerkungen
Beachten Sie, dass die folgenden Flags, die nur mit Windows Vista verwendet werden, sich gegenseitig von anderen verwendeten Flags ausschließen: LVNI_PREVIOUS, LVNI_VISIBLEONLY, LVNI_SAMEGROUPONLY, LVNI_VISIBLEORDER, LVNI_DIRECTIONMASK und LVNI_STATEMASK.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
| Header |
|