TreeView_GetNextItem Makro (commctrl.h)

  • Artikel

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

Syntax

void TreeView_GetNextItem(
   hwnd,
   hitem,
   code
);

Parameter

hwnd

Typ: HWND

Handle mit dem Strukturansichtssteuerelement.

hitem

Typ: HTREEITEM

Handle mit einem Element.

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 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 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 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 dem angegebenen 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 vorangeht. 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 allererste Element des Strukturansichtssteuerelements ab. Sie können das makro TreeView_GetRoot verwenden, um diese Nachricht zu senden.

Rückgabewert

Keine

Bemerkungen

Dieses Makro gibt NULL zurück, wenn das abgerufene Element der Stammknoten der Struktur ist. Wenn Sie beispielsweise dieses Makro mit dem flag TVGN_PARENT auf einem untergeordneten Element der ersten Ebene des Stammknotens der Strukturansicht verwenden, gibt das Makro NULL zurück.

Anforderungen

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