TreeView_SelectSetFirstVisible Makro (commctrl.h)

Scrollt das Strukturansicht-Steuerelement vertikal, um sicherzustellen, dass das angegebene Element sichtbar ist. Wenn möglich, wird das angegebene Element zum ersten sichtbaren Element am oberen Rand des Steuerelementfensters. Sie können dieses Makro oder das TreeView_Select Makro verwenden oder die TVM_SELECTITEM Nachricht explizit senden.

Syntax

BOOL TreeView_SelectSetFirstVisible(
   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

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.

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_SelectSetFirstVisible-Makros entspricht dem Senden der TVM_SELECTITEM Nachricht mit dem Flag Parameter, der auf den TVGN_FIRSTVISIBLE Wert festgelegt ist.

Anforderungen