TVM_SELECTITEM Nachricht

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