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
Commctrl.h