Freigeben über

ListView_GetNextItem Makro (commctrl.h)

  • Artikel

Sucht nach einem Listenansichtselement mit den angegebenen Eigenschaften und trägt die angegebene Beziehung zu einem angegebenen Element. Sie können dieses Makro verwenden oder die LVM_GETNEXTITEM Nachricht explizit senden.

Syntax

int ListView_GetNextItem(
   HWND hwnd,
   int  i,
   UINT flags
);

Parameter

hwnd

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

i

Typ: int

Der Index des Elements, mit dem die Suche begonnen werden soll, oder -1, um das erste Element zu finden, das den angegebenen Flags entspricht. Das angegebene Element selbst wird von der Suche ausgeschlossen.

flags

Typ: UINT-

Die geometrische Beziehung des angeforderten Elements zum angegebenen Element und, falls angegeben, den Zustand des angeforderten Elements. Eine Liste der möglichen Werte finden Sie in der Beschreibung des lParam- Parameters in der LVM_GETNEXTITEM Nachricht. Wenn für ein Element nicht alle angegebenen Statuskennzeichnungen festgelegt sind, wird die Suche mit dem nächsten Element fortgesetzt.

Rückgabewert

Typ: int

Gibt den Index des nächsten Elements zurück, wenn das Element erfolgreich verläuft oder andernfalls -1.

Anforderungen

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