LVM _ GETNEXTITEM-Nachricht
Sucht nach einem Listenansichtselement, das über die angegebenen Eigenschaften verfügt und die angegebene Beziehung zu einem angegebenen Element trägt. Sie können diese Nachricht explizit oder mithilfe des ListView _ GetNextItem-Makros senden.
Parameter
-
wParam
-
Index des Elements, mit dem die Suche beginnen soll, oder -1, um das erste Element zu finden, das den angegebenen Flags entspricht. Das angegebene Element selbst wird von der Suche ausgeschlossen.
-
lParam
-
Gibt die Beziehung zu dem in wParam angegebenen Element an. Dies kann eine oder eine Kombination der folgenden Werte sein:
Wert Bedeutung - Sucht nach Index.
- LVNI _ ALL
Sucht nach einem nachfolgenden Element nach Index, dem Standardwert. - LVNI _ PREVIOUS
Windows Vista und höher: Sucht nach einem Element, das vor dem in wParam angegebenen Element geordnet ist. Das LVNI PREVIOUS-Flag ist nicht direktional (LVNI ABOVE findet das oben positionierte Element, während LVNI PREVIOUS das zuvor _ _ geordnete Element _ findet.) Das LVNI PREVIOUS-Flag kehrt im Grunde die Logik der Suche um, die von _ den LVM _ GETNEXTITEM- oder LVM _ GETNEXTITEMINDEX-Nachrichten ausgeführt wird. - Sucht nach physischer Beziehung zum Index des Elements, an dem die Suche beginnen soll.
- LVNI _ OBEN
Sucht nach einem Element, das sich über dem angegebenen Element befindet. - LVNI _ UNTEN
Sucht nach einem Element unterhalb des angegebenen Elements. - LVNI _ TOLEFT
Sucht nach einem Element links vom angegebenen Element. - LVNI _ TORIGHT
Sucht nach einem Element rechts vom angegebenen Element. - LVNI _ DIRECTIONMASK
Windows Vista und höher: Eine direktionale Flagmaske mit folgendem Wert: LVNI _ ABOVE | LVNI _ BELOW | LVNI _ TOLEFT | LVNI _ TORIGHT. - Der Zustand des zu suchenden Elements kann mit einem oder einer Kombination der folgenden Werte angegeben werden:
- LVNI _ CUT
Für das Element ist das LVIS _ CUT-Zustandsflag festgelegt. - LVNI _ DROPHILITED
Für das Element ist das LVIS _ DROPHILITED-Zustandsflag festgelegt. - _ LVNI-FOKUS
Für das Element ist das LVIS _ FOCUSED-Zustandsflag festgelegt. - LVNI _ SELECTED
Für das Element ist das LVIS _ SELECTED-Statusflag festgelegt. - LVNI _ STATEMASK
Windows Vista und höher: Eine Zustandsflagmaske mit folgendem Wert: LVNI _ FOCUSED | LVNI _ SELECTED | LVNI CUT _ | LVNI _ DROPHILITED. - Suchen 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: Durchsuchen Sie die sichtbaren Elemente. - LVNI _ SAMEGROUPONLY
Windows Vista und höher: Durchsuchen Sie die aktuelle Gruppe. - Wenn für ein Element nicht alle angegebenen Zustandsflags festgelegt sind, wird die Suche mit dem nächsten Element fortgesetzt.
Rückgabewert
Gibt bei Erfolg den Index des nächsten Elements zurück, andernfalls -1.
Hinweise
Beachten Sie, dass die folgenden Flags, die nur mit Windows Vista verwendet werden, sich gegenseitig von anderen flags ausschließen, die verwendet werden: LVNI _ VISIBLEONLY, LVNI _ SAMEGROUPONLY, LVNI _ VISIBLEORDER, LVNI _ DIRECTIONMASK und LVNI _ STATEMASK.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Header |
|