macro TreeView_DeleteAllItems (commctrl.h)

Article
10/24/2024

Supprime tous les éléments d’un contrôle d’arborescence.

Syntaxe

BOOL TreeView_DeleteAllItems(
   HWND hwnd
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle d’arborescence.

Valeur de retour

Type : BOOL

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

Remarques

Une fois qu’un élément est supprimé d’un contrôle d’arborescence, son handle HTREEITEM 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.

Vous pouvez également supprimer tous les éléments avec la macro TreeView_DeleteItem ou le message TVM_DELETEITEM en définissant lParam sur TVI_ROOT.

Si le style de fenêtre d’un contrôle d’arborescence contient TVS_NOSCROLL et que tous les éléments sont supprimés, les nouveaux éléments ne sont pas affichés tant que les styles de fenêtre ne sont pas réinitialisés. Le code suivant montre une façon de s’assurer que les éléments sont toujours affichés.

DWORD styles = GetWindowLong(hwnd, GWL_STYLE);
TreeView_DeleteAllItems(hwnd);
SetWindowLong(hwnd, GWL_STYLE, styles);

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