TreeView_Expand Makro (commctrl.h)

Artikel
03/01/2024

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

Syntax

void TreeView_Expand(
   hwnd,
   hitem,
   code
);

Parameter

hwnd

Typ: HWND

Handle mit einem Strukturansichtssteuerelement.

hitem

Typ: HTREEITEM

Handle mit dem übergeordneten Element, das erweitert oder reduziert wird.

code

Typ: UINT

Aktionsflag. Eine Liste der möglichen Werte finden Sie in der Beschreibung des Flagparameters in TVM_EXPAND.

Rückgabewert

Keine

Bemerkungen

Das Erweitern eines bereits erweiterten Knotens oder das Zusammenbrechen eines Knotens, der bereits reduziert wurde, wird als erfolgreicher Vorgang betrachtet, und das Makro gibt einen wert ohne Wert zurück. Der Versuch, einen Knoten ohne untergeordnete Elemente zu erweitern oder zu reduzieren, wird als Fehler betrachtet, und der Rückgabewert ist 0.

Wenn ein Element zuerst durch eine TVM_EXPAND-Nachricht erweitert wird, generiert die Aktion TVN_ITEMEXPANDING und TVN_ITEMEXPANDED Benachrichtigungscodes, und das TVIS_EXPANDEDONCE Statusflag des Elements wird festgelegt. Solange dieses Statusflag festgelegt bleibt, generieren nachfolgende TVM_EXPAND Nachrichten keine TVN_ITEMEXPANDING oder TVN_ITEMEXPANDED Benachrichtigungen. Um das TVIS_EXPANDEDONCE-Statusflag zurückzusetzen, müssen Sie eine TVM_EXPAND Nachricht mit den TVE_COLLAPSE- und TVE_COLLAPSERESET-Flags senden. Der Versuch, TVIS_EXPANDEDONCE explizit festzulegen, führt zu unvorhersehbarem Verhalten.

Der Erweiterungsvorgang schlägt möglicherweise fehl, wenn der Besitzer des Treeview-Steuerelements den Vorgang als Reaktion auf eine TVN_ITEMEXPANDING Benachrichtigung verweigert.

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

Share via