macro TreeView_DeleteItem (commctrl.h)

Supprime un élément et tous ses enfants d’un contrôle d’arborescence. Vous pouvez également envoyer le message TVM_DELETEITEM explicitement.

Syntaxe

void TreeView_DeleteItem(
   hwnd,
   hitem
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle arborescence.

hitem

Type : HTREEITEM

HTREEITEM gère l’élément à supprimer. Si hitem est défini sur TVI_ROOT, tous les éléments sont supprimés du contrôle arborescence. Vous pouvez également utiliser la macro TreeView_DeleteAllItems pour supprimer tous les éléments.

Valeur de retour

Aucune

Remarques

Il n’est pas possible de supprimer des éléments en réponse à une notification telle que TVN_SELCHANGING.

Une fois qu’un élément est supprimé, son handle n’est pas valide et ne peut pas être utilisé.

La fenêtre parente reçoit un code de notification TVN_DELETEITEM lorsque chaque élément est supprimé.

Si l’étiquette d’élément est en cours de modification, l’opération de modification est annulée et la fenêtre parente reçoit le code de notification TVN_ENDLABELEDIT .

Si vous supprimez tous les éléments d’un contrôle d’arborescence qui a le style TVS_NOSCROLL , les éléments ajoutés par la suite risquent de ne pas s’afficher correctement. Pour plus d’informations, consultez TreeView_DeleteAllItems.

Configuration requise

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