ListView_GetNextItemIndex-Makro (commctrl.h)
Ruft den Index des Elements in einem bestimmten Listenansichtssteuerelement ab, das über die angegebenen Eigenschaften und die Beziehung zu einem anderen bestimmten Element verfügt. Verwenden Sie dieses Makro, oder senden Sie die LVM_GETNEXTITEMINDEX Nachricht explizit.
Syntax
void ListView_GetNextItemIndex(
[in] hwnd,
[in, out] plvii,
flags
);
Parameter
[in] hwnd
Typ: HWND
Ein Handle für das Listenansicht-Steuerelement.
[in, out] plvii
Typ: LVITEMINDEX*
Ein Zeiger auf die LVITEMINDEX-Struktur , mit der das Element die Suche beginnt, 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.
flags
Typ: LPARAM
Die Beziehung zu dem im Parameter plvii angegebenen Element. Dies kann ein oder eine Kombination der folgenden Werte sein:
Wert | Bedeutung |
---|---|
|
|
|
Sucht nach einem nachfolgenden Element nach Index, dem Standardwert. |
|
|
|
Sucht nach einem Element, das sich oberhalb des angegebenen Elements befindet. |
|
Sucht nach einem Element, das sich unterhalb des angegebenen Elements befindet. |
|
Sucht links neben dem angegebenen Element nach einem Element. |
|
Windows Vista und höher: Sucht nach dem Element, das sich vor dem angegebenen Element befindet. 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 im Wesentlichen die Logik der Suche um, die über die LVM_GETNEXTITEM oder LVM_GETNEXTITEMINDEX Nachrichten ausgeführt wird. |
|
Sucht rechts neben dem angegebenen Element nach einem Element. |
|
Windows Vista und höher: Ein direktionales Flagformat mit folgendem Wert: LVNI_ABOVE | LVNI_BELOW | LVNI_TOLEFT | LVNI_TORIGHT. |
|
|
|
Für das Element ist das LVIS_CUT Statusflag festgelegt. |
|
Für das Element ist das LVIS_DROPHILITED-Statusflag festgelegt. |
|
Für das Element ist das LVIS_FOCUSED Statusflag festgelegt. |
|
Für das Element ist das LVIS_SELECTED Statusflag festgelegt. |
|
Windows Vista und höher: Eine Statusflagsmaske mit folgendem Wert: LVNI_FOCUSED | LVNI_SELECTED | LVNI_CUT | LVNI_DROPHILITED. |
|
|
|
Windows Vista und höher: Suchen Sie die sichtbare Reihenfolge. |
|
Windows Vista und höher: Suchen Sie die sichtbaren Elemente. |
|
Windows Vista und höher: Durchsuchen Sie die aktuelle Gruppe. |
|
Rückgabewert
Keine
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] |
Zielplattform | Windows |
Kopfzeile | commctrl.h |