TreeView_DeleteAllItems macro (commctrl.h)

Article
03/01/2024

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

Syntaxe

void TreeView_DeleteAllItems(
   hwnd
);

Paramètres

hwnd

Type : HWND

Gérez le contrôle d’arborescence.

Valeur de retour

None

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 des 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);

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

Partager via