TVM_EXPAND message

Le message TVM_EXPAND développe ou réduit la liste des éléments enfants associés à l’élément parent spécifié, le cas échéant. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_Expand .

Paramètres

wParam

Indicateur d’action. Ce paramètre peut être une ou plusieurs des valeurs suivantes :

Valeur Signification
TVE_COLLAPSE
Réduit la liste.
TVE_COLLAPSERESET
Réduit la liste et supprime les éléments enfants. L’indicateur d’état TVIS_EXPANDEDONCE est réinitialisé. Cet indicateur doit être utilisé avec l’indicateur TVE_COLLAPSE.
TVE_EXPAND
Développe la liste.
TVE_EXPANDPARTIAL
Version 4.70. Développe partiellement la liste. Dans cet état, les éléments enfants sont visibles et le signe plus de l’élément parent (+), indiquant qu’il peut être développé, s’affiche. Cet indicateur doit être utilisé en combinaison avec l’indicateur TVE_EXPAND.
TVE_TOGGLE
Réduit la liste si elle est développée ou la développe si elle est réduite.

lParam

Gérez l’élément parent à développer ou à réduire.

Valeur retournée

Retourne une valeur différente de zéro si l’opération a réussi, ou zéro dans le cas contraire.

Notes

Le développement d’un nœud déjà développé est considéré comme une opération réussie et SendMessage retourne une valeur différente de zéro. L’effondrement d’un nœud retourne zéro si le nœud est déjà réduit ; sinon, il retourne des valeurs différentes de zéro. La tentative de développement ou de réduction d’un nœud qui n’a pas d’enfants est considérée comme un échec et SendMessage retourne zéro.

Lorsqu’un élément est développé pour la première fois par un message TVM_EXPAND , l’action génère TVN_ITEMEXPANDING et TVN_ITEMEXPANDED codes de notification, et l’indicateur d’état TVIS_EXPANDEDONCE de l’élément est défini. Tant que cet indicateur d’état reste défini, les messages TVM_EXPAND suivants ne génèrent pas de notifications TVN_ITEMEXPANDING ou TVN_ITEMEXPANDED. Pour réinitialiser l’indicateur d’état TVIS_EXPANDEDONCE , vous devez envoyer un message TVM_EXPAND avec les indicateurs TVE_COLLAPSE et TVE_COLLAPSERESET définis. La tentative de définition explicite TVIS_EXPANDEDONCE entraîne un comportement imprévisible.

L’opération de développement peut échouer si le propriétaire du contrôle treeview refuse l’opération en réponse à une notification TVN_ITEMEXPANDING .

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2003 [applications de bureau uniquement]
En-tête
Commctrl.h