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 le message TVM_EXPAND explicitement.

Syntaxe

void TreeView_Expand(
   hwnd,
   hitem,
   code
);

Paramètres

hwnd

Type : HWND

Gérez 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 d’indicateur dans TVM_EXPAND.

Valeur de retour

None

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 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 la valeur de retour est 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 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. Une 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 .

Configuration requise

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]
Plateforme cible	Windows
En-tête	commctrl.h