Freigeben über

TVM_SELECTITEM Nachricht

  • Artikel

Wählt das angegebene Strukturansichtselement aus, scrollt das Element in die Ansicht oder zeichnet das Element in der Formatvorlage neu, die verwendet wird, um das Ziel eines Drag-and-Drop-Vorgangs anzugeben. Sie können diese Nachricht explizit oder mithilfe des Makros TreeView_Select, TreeView_SelectItem oder TreeView_SelectDropTarget senden.

Parameter

wParam

Aktionsflag. Dieser Parameter kann einer der folgenden Werte sein:

Wert Bedeutung
TVGN_CARET
 Legt die Auswahl auf das angegebene Element fest. Das übergeordnete Fenster des Strukturansichtssteuerelements empfängt die TVN_SELCHANGING und TVN_SELCHANGED Benachrichtigungscodes.
TVGN_DROPHILITE
 Zeichnet das angegebene Element in der Formatvorlage neu aus, die verwendet wird, 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 am oberen Rand des Steuerelementfensters an. Strukturansichtssteuerelemente zeigen so viele Elemente an, wie in das Fenster passen. Wenn sich das angegebene Element in der nähe des unteren Bereichs der Elementhierarchie des Steuerelements befindet, wird es möglicherweise nicht zum ersten sichtbaren Element, je nachdem, wie viele Elemente in das Fenster passen.
TVSI_NOSINGLEEXPAND
 Wenn ein einzelnes Element ausgewählt ist, wird sichergestellt, dass die Strukturansicht die untergeordneten Elemente dieses Elements nicht erweitert. Dies ist nur gültig, wenn sie mit dem flag TVGN_CARET verwendet wird.
Hinweis: Um dieses Flag zu verwenden, müssen Sie ein Manifest angeben, das Comclt32.dll Version 6.0 angibt. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

lParam

Handle mit einem Element. Wenn lParamNULL ist, wird das Steuerelement auf kein ausgewähltes Element festgelegt.

Rückgabewert

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE .

Hinweise

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 des Steuerelements die TVN_ITEMEXPANDING und TVN_ITEMEXPANDED Benachrichtigungscodes.

Die Verwendung des TreeView_SelectItem Makros entspricht dem Senden der TVM_SELECTITEM Nachricht, wobei wParam auf den TVGN_CARET-Wert festgelegt ist. Die Verwendung des TreeView_SelectDropTarget Makros entspricht dem Senden der TVM_SELECTITEM Nachricht, wobei wParam auf den TVGN_DROPHILITE-Wert festgelegt ist. Die Verwendung von TreeView_SelectSetFirstVisible entspricht dem Senden der TVM_SELECTITEM Nachricht, wobei wParam auf den TVGN_FIRSTVISIBLE-Wert festgelegt ist.

Anforderungen

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