TreeView_GetNextItem Makro (commctrl.h)

2024-10-24

Ruft das Strukturansichtselement ab, das die angegebene Beziehung zu einem angegebenen Element trägt. Sie können dieses Makro verwenden, eines der unten beschriebenen TreeView_Get Makros verwenden oder die TVM_GETNEXTITEM Nachricht explizit senden.

Syntax

HTREEITEM TreeView_GetNextItem(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

Parameter

hwnd

Typ: HWND-

Behandeln sie das Strukturansichtssteuerelement.

hitem

Typ: HTREEITEM-

Behandeln eines Elements.

code

Typ: UINT-

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 Elements ab, das durch den hitem Parameter angegeben wurde. 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 sichtbare Element ab. Sie können das makro TreeView_GetFirstVisible 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 nächste 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 Nachricht, 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 vorausgeht. Das angegebene Element muss sichtbar sein. Verwenden Sie die TVM_GETITEMRECT Nachricht, 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 sehr erste Element des Strukturansicht-Steuerelements ab. Sie können das makro TreeView_GetRoot verwenden, um diese Nachricht zu senden.

Rückgabewert

Typ: HTREEITEM-

Gibt das Handle an das Element zurück, wenn dies erfolgreich ist. In den meisten Fällen gibt die Nachricht einen NULL- Wert zurück, um einen Fehler anzugeben. Ausführliche Informationen finden Sie im Abschnitt "Hinweise".

Bemerkungen

Dieses Makro gibt NULL- zurück, wenn das abgerufene Element der Stammknoten der Struktur ist. Wenn Sie dieses Makro z. B. mit dem TVGN_PARENT-Flag auf einem untergeordneten Element der Strukturansichtsstammknoten verwenden, gibt das Makro NULL-zurück.

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

Freigeben über