TreeView_Select Makro (commctrl.h)

Artikel
10/24/2024

Wählt das angegebene Strukturansichtselement aus, scrollt das Element in die Ansicht oder gliedert das Element in der Formatvorlage neu, um das Ziel eines Drag-and-Drop-Vorgangs anzugeben. Sie können dieses Makro oder das TreeView_SelectItem, TreeView_SelectSetFirstVisibleoder TreeView_SelectDropTarget Makros verwenden oder die TVM_SELECTITEM Nachricht explizit senden.

Syntax

BOOL TreeView_Select(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

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.

code

Typ: UINT-

Aktionsflagge. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
TVGN_CARET	Legt die Auswahl auf das angegebene Element fest. Das übergeordnete Fenster des Steuerelements empfängt die TVN_SELCHANGING und TVN_SELCHANGED Benachrichtigungscodes.
TVGN_DROPHILITE	Das angegebene Element in der Formatvorlage wird neu gezeichnet, um das Ziel eines Drag-and-Drop-Vorgangs anzugeben.
TVGN_FIRSTVISIBLE	Stellt sicher, dass das angegebene Element sichtbar ist, und zeigt es nach Möglichkeit oben im Fenster des Steuerelements an. Strukturansichtssteuerelemente zeigen so viele Elemente an, wie sie in das Fenster passen. Wenn sich das angegebene Element am unteren Rand der Elementhierarchie des Steuerelements befindet, wird es möglicherweise nicht zum ersten sichtbaren Element, je nachdem, wie viele Elemente in das Fenster passen.

Rückgabewert

Typ: BOOL-

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

Bemerkungen

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.

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