TVM_GETNEXTITEM Nachricht

  • Artikel

Ruft das Strukturansichtselement ab, das die angegebene Beziehung zu einem angegebenen Element trägt. Sie können diese Nachricht explizit senden, indem Sie das Makro TreeView_GetNextItem verwenden.

Parameter

wParam

Flag, das das abzurufende Element angibt. Dieser Parameter kann einer der folgenden Werte sein:

Wert Bedeutung
TVGN_CARET
 Ruft das aktuell ausgewählte Element ab. Sie können das Makro TreeView_GetSelection verwenden, um diese Nachricht zu senden.
TVGN_CHILD
 Ruft das erste untergeordnete Element des durch den hitem-Parameter angegebenen Elements ab. Sie können das Makro TreeView_GetChild verwenden, um diese Nachricht zu senden.
TVGN_DROPHILITE
 Ruft das Element ab, das das Ziel eines Drag-and-Drop-Vorgangs ist. Sie können das Makro TreeView_GetDropHilight verwenden, um diese Nachricht zu senden.
TVGN_FIRSTVISIBLE
 Ruft das erste Element ab, das im Strukturansichtsfenster sichtbar ist. Sie können das Makro TreeView_GetFirstVisible verwenden, um diese Nachricht zu senden.
TVGN_LASTVISIBLE
 Version 4.71. Ruft das letzte erweiterte Element in der Struktur ab. Dadurch wird nicht das letzte element abgerufen, das im Strukturansichtsfenster sichtbar ist. Sie können das Makro TreeView_GetLastVisible verwenden, um diese Nachricht zu senden.
TVGN_NEXT
 Ruft das nächste gleichgeordnete Element ab. Sie können das Makro TreeView_GetNextSibling verwenden, um diese Nachricht zu senden.
TVGN_NEXTSELECTED
 Windows Vista und höher. Ruft das folgende ausgewählte Element ab. Sie können das Makro TreeView_GetNextSelected verwenden, um diese Nachricht zu senden.
TVGN_NEXTVISIBLE
 Ruft das nächste sichtbare Element ab, das auf das angegebene Element folgt. Das angegebene Element muss sichtbar sein. Verwenden Sie die TVM_GETITEMRECT Meldung, um zu bestimmen, ob ein Element sichtbar ist. Sie können das Makro TreeView_GetNextVisible verwenden, um diese Nachricht zu senden.
TVGN_PARENT
 Ruft das übergeordnete Element des angegebenen Elements ab. Sie können das Makro TreeView_GetParent verwenden, um diese Nachricht zu senden.
TVGN_PREVIOUS
 Ruft das vorherige gleichgeordnete Element ab. Sie können das Makro TreeView_GetPrevSibling verwenden, um diese Nachricht zu senden.
TVGN_PREVIOUSVISIBLE
 Ruft das erste sichtbare Element ab, das dem angegebenen Element vorangestellt ist. Das angegebene Element muss sichtbar sein. Verwenden Sie die TVM_GETITEMRECT Meldung, um zu bestimmen, ob ein Element sichtbar ist. Sie können das Makro TreeView_GetPrevVisible verwenden, um diese Nachricht zu senden.
TVGN_ROOT
 Ruft das oberste oder allererste Element des Strukturansichtssteuerelements ab. Sie können das Makro TreeView_GetRoot verwenden, um diese Nachricht zu senden.

lParam

Handle für ein Element.

Rückgabewert

Gibt bei erfolgreicher Ausführung das Handle an das Element zurück. In den meisten Fällen gibt die Nachricht einen NULL-Wert zurück, der auf einen Fehler hinweist. Weitere Informationen finden Sie im Abschnitt Hinweise.

Bemerkungen

Diese Meldung gibt NULL zurück, wenn das abgerufene Element der Stammknoten der Struktur ist. Wenn Sie diese Meldung beispielsweise mit dem flag TVGN_PARENT auf einem untergeordneten Element der ersten Ebene des Stammknotens der Strukturansicht verwenden, gibt die Nachricht NULL zurück.

Sie können auch eines der folgenden zugehörigen Makros verwenden:
TreeView_GetChild
TreeView_GetDropHilight
TreeView_GetFirstVisible
TreeView_GetLastVisible
TreeView_GetNextSibling
TreeView_GetNextVisible
TreeView_GetParent
TreeView_GetPrevSibling
TreeView_GetPrevVisible
TreeView_GetRoot
TreeView_GetSelection

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2003 [nur Desktop-Apps]
Header
Commctrl.h