TreeView_SelectSetFirstVisible Makro (commctrl.h)

Führt einen vertikalen Bildlauf im Strukturansichtssteuerelement durch, um sicherzustellen, dass das angegebene Element sichtbar ist. Wenn möglich, wird das angegebene Element zum ersten sichtbaren Element oben im Fenster des Steuerelements. Sie können dieses Makro oder das makro TreeView_Select verwenden oder die TVM_SELECTITEM Nachricht explizit senden.

Syntax

void TreeView_SelectSetFirstVisible(
   hwnd,
   hitem
);

Parameter

hwnd

Typ: HWND

Handle für das Strukturansichtssteuerelement.

hitem

Typ: HTREEITEM

Handle für ein Element. Wenn der hitem-ParameterNULL ist, wird das Steuerelement auf kein ausgewähltes Element festgelegt.

Rückgabewert

Keine

Bemerkungen

Strukturansichtssteuerelemente zeigen so viele Elemente an, wie 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, deren flag-Parameter auf den wert TVGN_FIRSTVISIBLE festgelegt ist.

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