TreeView_SelectItem Makro (commctrl.h)

Artikel
10/24/2024

Wählt das angegebene Strukturansichtselement aus. Sie können dieses Makro oder das TreeView_Select Makro verwenden oder die TVM_SELECTITEM Nachricht explizit senden.

Syntax

BOOL TreeView_SelectItem(
   HWND      hwnd,
   HTREEITEM hitem
);

Parameter

hwnd

Typ: HWND-

Behandeln sie das Strukturansichtssteuerelement.

hitem

Typ: HTREEITEM-

Behandeln eines Elements. Wenn der Hitem--Parameter NULL-ist, wird das Steuerelement so festgelegt, dass kein ausgewähltes Element vorhanden ist.

Rückgabewert

Typ: BOOL-

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

Bemerkungen

Wenn Sie das makro TreeView_SelectItem aufrufen, empfängt das übergeordnete Fenster des Steuerelements die TVN_SELCHANGING und TVN_SELCHANGED Benachrichtigungscodes. Wenn das angegebene Element das untergeordnete Element eines reduzierten übergeordneten Elements ist, wird die Liste der untergeordneten Elemente des übergeordneten Elements erweitert, um das angegebene Element anzuzeigen. In diesem Fall empfängt das übergeordnete Fenster die TVN_ITEMEXPANDING und TVN_ITEMEXPANDED Benachrichtigungscodes.

Die Verwendung des TreeView_SelectItem-Makros entspricht dem Senden der TVM_SELECTITEM Nachricht mit dem Flag, Parameter auf den TVGN_CARET Wert festgelegt ist.

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