Partager via


TVM_DELETEITEM message

Supprime un élément et tous ses enfants d’un contrôle d’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_DeleteItem .

Paramètres

wParam

Doit être zéro.

lParam

Handle HTREEITEM pour l’élément à supprimer. Si lParam est défini sur TVI_ROOT ou sur NULL, tous les éléments sont supprimés. Vous pouvez également utiliser la macro TreeView_DeleteAllItems pour supprimer tous les éléments.

Valeur retournée

Retourne TRUE en cas de réussite, ou FALSE dans le cas contraire.

Notes

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.

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