macro TreeView_Expand (commctrl.h)

La macro TreeView_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 utiliser cette macro ou envoyer explicitement le message TVM_EXPAND.

Syntaxe

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

Paramètres

hwnd

Type : HWND

Gérer vers un contrôle d’arborescence.

hitem

Type : HTREEITEM

Gérez l’élément parent qui sera développé ou réduit.

code

Type : UINT

Indicateur d’action. Pour obtenir la liste des valeurs possibles, consultez la description du paramètre wParam dans TVM_EXPAND.

Valeur de retour

Type : BOOL

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

Remarques

Le développement d’un nœud déjà développé ou la réduction d’un nœud déjà réduit est considéré comme une opération réussie et la macro retourne une valeur différente de zéro. La tentative d’expansion ou de réduction d’un nœud qui n’a aucun enfant n’est considérée comme un échec et la valeur de retour est égale à zéro.

Lorsqu’un élément est développé pour la première fois par un message TVM_EXPAND, l’action génère des codes de notification TVN_ITEMEXPANDING et TVN_ITEMEXPANDED 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 de 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 le TVE_COLLAPSE et les indicateurs de TVE_COLLAPSERESET définis. Toute tentative de définition explicite de 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	commctrl.h