Freigeben über

TVM_EXPAND Nachricht

  • Artikel

Die TVM_EXPAND Meldung erweitert oder reduziert die Liste der untergeordneten Elemente, die dem angegebenen übergeordneten Element zugeordnet sind, sofern vorhanden. Sie können diese Nachricht explizit oder mithilfe des Makros TreeView_Expand senden.

Parameter

wParam

Aktionsflag. Bei diesem Parameter kann es sich um einen oder mehrere der folgenden Werte handeln:

Wert Bedeutung
TVE_COLLAPSE
 Reduziert die Liste.
TVE_COLLAPSERESET
 Reduziert die Liste und entfernt die untergeordneten Elemente. Das TVIS_EXPANDEDONCE Statusflag wird zurückgesetzt. Dieses Flag muss mit dem flag TVE_COLLAPSE verwendet werden.
TVE_EXPAND
 Erweitert die Liste.
TVE_EXPANDPARTIAL
 Version 4.70. Erweitert die Liste teilweise. In diesem Zustand sind die untergeordneten Elemente sichtbar, und das Pluszeichen (+) des übergeordneten Elements, das angibt, dass es erweitert werden kann, wird angezeigt. Dieses Flag muss in Kombination mit dem flag TVE_EXPAND verwendet werden.
TVE_TOGGLE
 Reduziert die Liste, wenn sie erweitert wird, oder erweitert sie, wenn sie reduziert ist.

lParam

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

Rückgabewert

Gibt ungleich null zurück, wenn der Vorgang erfolgreich war, oder andernfalls null.

Bemerkungen

Das Erweitern eines bereits erweiterten Knotens gilt als erfolgreicher Vorgang, und SendMessage gibt einen Wert ungleich null zurück. Beim Reduzieren eines Knotens wird 0 (null) zurückgegeben, wenn der Knoten bereits reduziert ist. Andernfalls wird ungleich null zurückgegeben. Der Versuch, einen Knoten ohne untergeordnete Elemente zu erweitern oder zu reduzieren, gilt als Fehler, und SendMessage gibt null zurück.

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 kann fehlschlagen, wenn der Besitzer des Treeview-Steuerelements den Vorgang als Reaktion auf eine TVN_ITEMEXPANDING Benachrichtigung ablehnt.

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