TreeView_Expand Makro (commctrl.h)

Artikel
10/24/2024

Das TreeView_Expand Makros erweitert oder reduziert die Liste der untergeordneten Elemente, die dem angegebenen übergeordneten Element zugeordnet sind, sofern vorhanden. Sie können dieses Makro verwenden oder die TVM_EXPAND Nachricht explizit senden.

Syntax

BOOL TreeView_Expand(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

Parameter

hwnd

Typ: HWND-

Behandeln sie ein Strukturansichtssteuerelement.

hitem

Typ: HTREEITEM-

Behandeln Sie das übergeordnete Element, das erweitert oder reduziert wird.

code

Typ: UINT-

Aktionsflagge. Eine Liste der möglichen Werte finden Sie in der Beschreibung des wParam- Parameters in TVM_EXPAND.

Rückgabewert

Typ: BOOL-

Gibt "nonzero" zurück, wenn der Vorgang erfolgreich war, oder 0 andernfalls null.

Bemerkungen

Das Erweitern eines bereits erweiterten Knotens oder das Reduzieren eines bereits reduzierten Knotens wird als erfolgreicher Vorgang betrachtet, und das Makro gibt einen Wert ungleich Null zurück. Beim Versuch, einen Knoten zu erweitern oder zu reduzieren, der keine untergeordneten Elemente enthält, wird als Fehler betrachtet, und der Rückgabewert ist Null.

Wenn ein Element zum ersten Mal durch eine TVM_EXPAND Nachricht erweitert wird, generiert die Aktion TVN_ITEMEXPANDING und TVN_ITEMEXPANDED Benachrichtigungscodes, und das TVIS_EXPANDEDONCE Statuskennzeichnung des Elements wird festgelegt. Solange diese Statuskennzeichnung festgelegt bleibt, generieren nachfolgende TVM_EXPAND Nachrichten keine TVN_ITEMEXPANDING oder TVN_ITEMEXPANDED Benachrichtigungen. Um die TVIS_EXPANDEDONCE Statuskennzeichnung zurückzusetzen, müssen Sie eine TVM_EXPAND Nachricht senden, wobei die TVE_COLLAPSE und TVE_COLLAPSERESET Flags festgelegt sind. Der Versuch, TVIS_EXPANDEDONCE explizit festzulegen, führt zu unvorhersehbaren Verhaltensweisen.

Der Erweiterungsvorgang kann fehlschlagen, wenn der Besitzer des Strukturansichtssteuerelements den Vorgang als Reaktion auf eine TVN_ITEMEXPANDING-Benachrichtigung verweigert.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h

Freigeben über