ListView_GetNextItemIndex Makro (commctrl.h)

Artikel
10/24/2024

Ruft den Index des Elements in einem bestimmten Listenansicht-Steuerelement ab, das die angegebenen Eigenschaften und Beziehungen zu einem anderen bestimmten Element aufweist. Verwenden Sie dieses Makro, oder senden Sie die LVM_GETNEXTITEMINDEX Nachricht explizit.

Syntax

BOOL ListView_GetNextItemIndex(
  [in]      HWND        hwnd,
  [in, out] LVITEMINDEX *plvii,
            LPARAM      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 Aufrufprozess ist für die Zuordnung dieser Struktur und das Festlegen seiner Mitglieder verantwortlich.

flags

Typ: LPARAM-

Die Beziehung zum element, das im Parameter angegeben ist, plvii. 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.
Sucht nach physischer Beziehung zum Index des Elements, in dem die Suche beginnen soll.
LVNI_ABOVE	Sucht nach einem Element, das über dem angegebenen Element liegt.
LVNI_BELOW	Sucht nach einem Element, das unter dem angegebenen Element liegt.
LVNI_TOLEFT	Sucht links neben dem angegebenen Element nach einem Element.
LVNI_PREVIOUS	Windows Vista und höher: Sucht nach dem Element, das vor dem angegebenen Element liegt. Das LVNI_PREVIOUS Flag ist nicht direktional (LVNI_ABOVE wird das oben positionierte Element finden, während LVNI_PREVIOUS das zuvor sortierte Element finden wird.) Die LVNI_PREVIOUS Kennzeichnung kehrt im Wesentlichen die Logik der Suche zurück, die über die LVM_GETNEXTITEM oder LVM_GETNEXTITEMINDEX Nachrichten ausgeführt wird.
LVNI_TORIGHT	Sucht nach einem Element rechts neben dem angegebenen Element.
LVNI_DIRECTIONMASK	Windows Vista und höher: Eine direktionale Kennzeichnungsmaske mit Wert wie folgt: LVNI_ABOVE \| LVNI_BELOW \| LVNI_TOLEFT \| LVNI_TORIGHT.
Der Status des zu findenden Elements kann mit einer oder einer Kombination der folgenden Werte angegeben werden:
LVNI_CUT	Das Element hat die LVIS_CUT Statuskennzeichnung festgelegt.
LVNI_DROPHILITED	Das Element hat die LVIS_DROPHILITED Statuskennzeichnung festgelegt.
LVNI_FOCUSED	Das Element hat die LVIS_FOCUSED Statuskennzeichnung festgelegt.
LVNI_SELECTED	Das Element hat die LVIS_SELECTED Statuskennzeichnung festgelegt.
LVNI_STATEMASK	Windows Vista und höher: Ein Statuskennzeichnungsformat mit Wert wie folgt: 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: Aktuelle Gruppe durchsuchen.
Wenn für ein Element nicht alle angegebenen Statuskennzeichnungen festgelegt sind, wird die Suche mit dem nächsten Element fortgesetzt.

Rückgabewert

Typ: BOOL-

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls.

Bemerkungen

Beachten Sie, dass die folgenden Flags, die nur für Windows Vista verwendet werden, sich gegenseitig von allen anderen verwendeten Flags ausschließen: LVNI_PREVIOUS, LVNI_VISIBLEONLY, LVNI_SAMEGROUPONLY, LVNI_VISIBLEORDER, LVNI_DIRECTIONMASK und LVNI_STATEMASK.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h

Siehe auch

LVM_GETNEXTITEM

Freigeben über