macro TreeView_DeleteItem (commctrl.h)

Article
10/24/2024

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

Syntaxe

BOOL TreeView_DeleteItem(
   HWND      hwnd,
   HTREEITEM hitem
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle d’arborescence.

hitem

Type : HTREEITEM

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

Valeur de retour

Type : BOOL

Retourne TRUE en cas de réussite ou FALSE sinon.

Remarques

Il n’est pas sûr 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 peuvent ne pas s’afficher correctement. Pour plus d’informations, consultez TreeView_DeleteAllItems.

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

Partager via