TreeView_Select Makro (commctrl.h)

  • 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 dieses Makro oder die TreeView_SelectItem, TreeView_SelectSetFirstVisible oder TreeView_SelectDropTarget Makros verwenden oder die TVM_SELECTITEM-Nachricht explizit senden.

Syntax

void TreeView_Select(
   hwnd,
   hitem,
   code
);

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.

code

Typ: UINT

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 Steuerelements empfängt die TVN_SELCHANGING und TVN_SELCHANGED Benachrichtigungscodes.
TVGN_DROPHILITE
 Zeichnet das angegebene Element in der Formatvorlage neu aus, die zum Angeben des Ziels eines Drag-and-Drop-Vorgangs verwendet wird.
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 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

Keine

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

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commctrl.h