Arborescence

Cette section contient des informations sur les éléments de programmation utilisés avec les contrôles d’arborescence.

Vues d'ensemble

Rubrique	Contenu
À propos des contrôles Tree-View	Un contrôle d’arborescence est une fenêtre qui affiche une liste hiérarchique d’éléments, tels que les titres d’un document, les entrées d’un index ou les fichiers et répertoires sur un disque.
Utilisation de contrôles Tree-View	Cette section contient des détails d’implémentation et des exemples de code pour l’utilisation des contrôles d’arborescence.

Macros

Rubrique	Contenu
TreeView_CreateDragImage	Crée une bitmap de glissement pour l’élément spécifié dans un contrôle d’arborescence. La macro crée également une liste d’images pour la bitmap et ajoute la bitmap à la liste d’images. Une application peut afficher l’image en faisant glisser l’élément à l’aide des fonctions de liste d’images. Vous pouvez utiliser cette macro ou envoyer le message TVM_CREATEDRAGIMAGE explicitement.
TreeView_DeleteAllItems	Supprime tous les éléments d’un contrôle arborescence.
TreeView_DeleteItem	Supprime un élément et tous ses descendants d’un contrôle d’arborescence. Vous pouvez également envoyer le message TVM_DELETEITEM explicitement.
TreeView_EditLabel	Commence la modification sur place du texte de l’élément spécifié, en remplaçant le texte de l’élément par un contrôle d’édition sur une seule ligne contenant le texte. Cette macro sélectionne et concentre implicitement l’élément spécifié. Vous pouvez utiliser cette macro ou envoyer le message TVM_EDITLABEL explicitement.
TreeView_EndEditLabelNow	Termine la modification de l’étiquette d’un élément d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_ENDEDITLABELNOW explicitement.
TreeView_EnsureVisible	Garantit qu’un élément d’arborescence est visible, en développant l’élément parent ou en faisant défiler le contrôle d’arborescence, si nécessaire. Vous pouvez utiliser cette macro ou envoyer le message TVM_ENSUREVISIBLE explicitement.
TreeView_Expand	La macro TreeView_Expand développe ou réduit la liste des éléments enfants associés à l’élément parent spécifié, le cas échéant. Vous pouvez utiliser cette macro ou envoyer le message TVM_EXPAND explicitement.
TreeView_GetBkColor	Récupère la couleur d’arrière-plan actuelle du contrôle. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETBKCOLOR explicitement.
TreeView_GetCheckState	Obtient l’état case activée de l’élément spécifié. Vous pouvez également utiliser directement le message TVM_GETITEMSTATE .
TreeView_GetChild	Récupère le premier élément enfant de l’élément d’arborescence spécifié. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur TVGN_CHILD.
TreeView_GetCount	Récupère un nombre d’éléments dans un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETCOUNT explicitement.
TreeView_GetDropHilight	Récupère l’élément d’arborescence qui est la cible d’une opération de glisser-déplacer. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur TVGN_DROPHILITE.
TreeView_GetEditControl	Récupère le handle du contrôle d’édition utilisé pour modifier le texte d’un élément d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETEDITCONTROL explicitement.
TreeView_GetExtendedStyle	Récupère le style étendu pour un contrôle d’arborescence spécifié. Utilisez cette macro ou envoyez explicitement le message TVM_GETEXTENDEDSTYLE .
TreeView_GetFirstVisible	Récupère le premier élément visible dans une fenêtre de contrôle arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur TVGN_FIRSTVISIBLE.
TreeView_GetImageList	Récupère le handle dans la liste d’images normale ou d’état associée à un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETIMAGELIST explicitement.
TreeView_GetIndent	Récupère la quantité, en pixels, des éléments enfants mis en retrait par rapport à leurs éléments parents. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETINDENT explicitement.
TreeView_GetInsertMarkColor	Récupère la couleur utilisée pour dessiner la marque d’insertion de l’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETINSERTMARKCOLOR explicitement.
TreeView_GetISearchString	Récupère la chaîne de recherche incrémentielle pour un contrôle d’arborescence. Le contrôle arborescence utilise la chaîne de recherche incrémentielle pour sélectionner un élément en fonction des caractères tapés par l’utilisateur. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETISEARCHSTRING explicitement.
TreeView_GetItem	Récupère tout ou partie des attributs d’un élément d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETITEM explicitement.
TreeView_GetItemHeight	Récupère la hauteur actuelle des éléments d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETITEMHEIGHT explicitement.
TreeView_GetItemPartRect	Récupère le plus grand rectangle englobant possible qui constitue la « zone d’accès » pour une partie spécifiée d’un élément. Utilisez cette macro ou envoyez le message TVM_GETITEMPARTRECT explicitement.
TreeView_GetItemRect	Récupère le rectangle englobant d’un élément d’arborescence et indique si l’élément est visible. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETITEMRECT explicitement.
TreeView_GetItemState	Récupère tout ou partie des attributs d’état d’un élément d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETITEMSTATE explicitement.
TreeView_GetLastVisible	Récupère le dernier élément développé dans un contrôle arborescence. Cela ne récupère pas le dernier élément visible dans la fenêtre d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur TVGN_LASTVISIBLE.
TreeView_GetLineColor	Obtient la couleur de ligne actuelle. Vous pouvez également utiliser directement le message TVM_GETLINECOLOR .
TreeView_GetNextItem	Récupère l’élément d’arborescence qui porte la relation spécifiée avec un élément spécifié. Vous pouvez utiliser cette macro, utiliser l’une des macros TreeView_Get décrites ci-dessous ou envoyer le message TVM_GETNEXTITEM explicitement.
TreeView_GetNextSelected	Récupère l’élément d’arborescence qui porte la relation TVGN_NEXTSELECTED à un élément d’arborescence spécifié.
TreeView_GetNextSibling	Récupère l’élément frère suivant d’un élément spécifié dans un contrôle arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur TVGN_NEXT.
TreeView_GetNextVisible	Récupère l’élément visible suivant un élément spécifié dans un contrôle arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur TVGN_NEXTVISIBLE.
TreeView_GetParent	Récupère l’élément parent de l’élément d’arborescence spécifié. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur TVGN_PARENT.
TreeView_GetPrevSibling	Récupère l’élément frère précédent d’un élément spécifié dans un contrôle arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur TVGN_PREVIOUS.
TreeView_GetPrevVisible	Récupère le premier élément visible qui précède un élément spécifié dans un contrôle arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur TVGN_PREVIOUSVISIBLE.
TreeView_GetRoot	Récupère l’élément le plus haut ou le premier élément du contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur TVGN_ROOT.
TreeView_GetScrollTime	Récupère la durée de défilement maximale du contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETSCROLLTIME explicitement.
TreeView_GetSelectedCount	Non implémenté.
TreeView_GetSelection	Récupère l’élément actuellement sélectionné dans un contrôle arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur TVGN_CARET.
TreeView_GetTextColor	Récupère la couleur de texte actuelle du contrôle. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETTEXTCOLOR explicitement.
TreeView_GetToolTips	Récupère le handle du contrôle d’info-bulle enfant utilisé par un contrôle arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETTOOLTIPS explicitement.
TreeView_GetUnicodeFormat	Récupère l’indicateur de format de caractères Unicode pour le contrôle. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETUNICODEFORMAT explicitement.
TreeView_GetVisibleCount	Obtient le nombre d’éléments qui peuvent être entièrement visibles dans la fenêtre cliente d’un contrôle arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_GETVISIBLECOUNT explicitement.
TreeView_HitTest	Détermine l’emplacement du point spécifié par rapport à la zone cliente d’un contrôle arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_HITTEST explicitement.
TreeView_InsertItem	Insère un nouvel élément dans un contrôle arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_INSERTITEM explicitement.
TreeView_MapAccIDToHTREEITEM	Mappe un ID d’accessibilité à un élément HTREEITEM. Vous pouvez utiliser cette macro ou envoyer le message TVM_MAPACCIDTOHTREEITEM explicitement.
TreeView_MapHTREEITEMtoAccID	Mappe un élément HTREEITEM à un ID d’accessibilité. Vous pouvez utiliser cette macro ou envoyer le message TVM_MAPHTREEITEMTOACCID explicitement.
TreeView_Select	Sélectionne l’élément d’arborescence spécifié, fait défiler l’élément dans l’affichage ou redessine l’élément dans le style utilisé pour indiquer la cible d’une opération de glisser-déplacer. Vous pouvez utiliser cette macro ou les macros TreeView_SelectItem, TreeView_SelectSetFirstVisible ou TreeView_SelectDropTarget , ou vous pouvez envoyer le message TVM_SELECTITEM explicitement.
TreeView_SelectDropTarget	Redessine un élément de contrôle d’arborescence spécifié dans le style utilisé pour indiquer la cible d’une opération de glisser-déplacer. Vous pouvez utiliser cette macro ou la macro TreeView_Select , ou vous pouvez envoyer le message TVM_SELECTITEM explicitement.
TreeView_SelectItem	Sélectionne l’élément d’arborescence spécifié. Vous pouvez utiliser cette macro ou la macro TreeView_Select , ou vous pouvez envoyer le message TVM_SELECTITEM explicitement.
TreeView_SelectSetFirstVisible	Fait défiler le contrôle arborescence verticalement pour s’assurer que l’élément spécifié est visible. Si possible, l’élément spécifié devient le premier élément visible en haut de la fenêtre du contrôle. Vous pouvez utiliser cette macro ou la macro TreeView_Select , ou vous pouvez envoyer le message TVM_SELECTITEM explicitement.
TreeView_SetAutoScrollInfo	Définit les informations utilisées pour déterminer les caractéristiques de défilement automatique. Utilisez cette macro ou envoyez explicitement le message TVM_SETAUTOSCROLLINFO .
TreeView_SetBkColor	Définit la couleur d’arrière-plan du contrôle. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETBKCOLOR explicitement.
TreeView_SetBorder	Destiné à une utilisation interne ; non recommandé pour une utilisation dans les applications. Définit la taille de la bordure des éléments d’un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETBORDER explicitement.
TreeView_SetCheckState	Définit l’image d’état de l’élément sur « vérifié » ou « décoché ». Vous pouvez également utiliser le message TVM_SETITEM directement.
TreeView_SetExtendedStyle	Définit le style étendu d’un contrôle TreeView spécifié. Utilisez cette macro ou envoyez explicitement le message TVM_SETEXTENDEDSTYLE .
TreeView_SetHot	Destiné à une utilisation interne ; non recommandé pour une utilisation dans les applications. Définit l’élément chaud pour un contrôle arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETHOT explicitement.
TreeView_SetImageList	Définit la liste d’images normales ou d’état pour un contrôle d’arborescence et redessine le contrôle à l’aide des nouvelles images. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETIMAGELIST explicitement.
TreeView_SetIndent	Définit la largeur de mise en retrait d’un contrôle d’arborescence et redessine le contrôle pour refléter la nouvelle largeur. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETINDENT explicitement.
TreeView_SetInsertMark	Définit la marque d’insertion dans un contrôle arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETINSERTMARK explicitement.
TreeView_SetInsertMarkColor	Définit la couleur utilisée pour dessiner la marque d’insertion pour l’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETINSERTMARKCOLOR explicitement.
TreeView_SetItem	La macro TreeView_SetItem définit tout ou partie des attributs d’un élément d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETITEM explicitement.
TreeView_SetItemHeight	Définit la hauteur des éléments d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETITEMHEIGHT explicitement.
TreeView_SetItemState	Définit les attributs d’état d’un élément d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETITEM explicitement.
TreeView_SetLineColor	Définit la couleur de ligne actuelle. Vous pouvez également utiliser le message TVM_SETLINECOLOR directement.
TreeView_SetScrollTime	Définit la durée de défilement maximale pour le contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETSCROLLTIME explicitement.
TreeView_SetTextColor	Définit la couleur du texte du contrôle. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETTEXTCOLOR explicitement.
TreeView_SetToolTips	Définit le contrôle d’info-bulle enfant d’un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETTOOLTIPS explicitement.
TreeView_SetUnicodeFormat	Définit l’indicateur de format de caractères Unicode pour le contrôle. Ce message vous permet de modifier le jeu de caractères utilisé par le contrôle au moment de l’exécution plutôt que d’avoir à recréer le contrôle. Vous pouvez utiliser cette macro ou envoyer le message TVM_SETUNICODEFORMAT explicitement.
TreeView_ShowInfoTip	Affiche l’info-bulle d’un élément spécifié dans un contrôle arborescence. Utilisez cette macro ou envoyez le message TVM_SHOWINFOTIP explicitement.
TreeView_SortChildren	Trie les éléments enfants de l’élément parent spécifié dans un contrôle arborescence. Vous pouvez utiliser cette macro ou envoyer le message TVM_SORTCHILDREN explicitement.
TreeView_SortChildrenCB	Trie les éléments d’arborescence à l’aide d’une fonction de rappel définie par l’application qui compare les éléments. Vous pouvez utiliser cette macro ou envoyer le message TVM_SORTCHILDRENCB explicitement.

Messages

Rubrique	Contenu
TVM_CREATEDRAGIMAGE	Crée une bitmap de glissement pour l’élément spécifié dans un contrôle arborescence. Le message crée également une liste d’images pour la bitmap et ajoute la bitmap à la liste d’images. Une application peut afficher l’image lors du déplacement de l’élément à l’aide des fonctions de liste d’images. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_CreateDragImage .
TVM_DELETEITEM	Supprime un élément et tous ses descendants d’un contrôle arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_DeleteItem .
TVM_EDITLABEL	Commence la modification sur place du texte de l’élément spécifié, en remplaçant le texte de l’élément par un contrôle de modification sur une ligne contenant le texte. Ce message sélectionne et concentre implicitement l’élément spécifié. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_EditLabel .
TVM_ENDEDITLABELNOW	Termine la modification de l’étiquette d’un élément d’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_EndEditLabelNow .
TVM_ENSUREVISIBLE	Garantit qu’un élément d’arborescence est visible, en développant l’élément parent ou en faisant défiler le contrôle d’arborescence, si nécessaire. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_EnsureVisible .
TVM_EXPAND	Le message TVM_EXPAND développe ou réduit la liste des éléments enfants associés à l’élément parent spécifié, le cas échéant. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_Expand .
TVM_GETBKCOLOR	Récupère la couleur d’arrière-plan actuelle du contrôle. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetBkColor .
TVM_GETCOUNT	Récupère le nombre d’éléments d’un contrôle arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetCount .
TVM_GETEDITCONTROL	Récupère le handle du contrôle d’édition utilisé pour modifier le texte d’un élément d’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetEditControl .
TVM_GETEXTENDEDSTYLE	Récupère le style étendu pour un contrôle d’arborescence. Envoyez ce message explicitement ou à l’aide de la macro TreeView_GetExtendedStyle .
TVM_GETIMAGELIST	Récupère le handle dans la liste d’images normale ou d’état associée à un contrôle arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetImageList .
TVM_GETINDENT	Récupère la quantité, en pixels, que les éléments enfants sont mis en retrait par rapport à leurs éléments parents. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetIndent .
TVM_GETINSERTMARKCOLOR	Récupère la couleur utilisée pour dessiner la marque d’insertion de l’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetInsertMarkColor .
TVM_GETISEARCHSTRING	Récupère la chaîne de recherche incrémentielle pour un contrôle arborescence. Le contrôle arborescence utilise la chaîne de recherche incrémentielle pour sélectionner un élément en fonction des caractères tapés par l’utilisateur. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetISearchString .
TVM_GETITEM	Récupère tout ou partie des attributs d’un élément d’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetItem .
TVM_GETITEMHEIGHT	Récupère la hauteur actuelle de chaque élément d’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetItemHeight .
TVM_GETITEMPARTRECT	Non implémenté.
TVM_GETITEMRECT	Récupère le rectangle englobant d’un élément d’arborescence et indique si l’élément est visible. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetItemRect .
TVM_GETITEMSTATE	Récupère tout ou partie des attributs d’état d’un élément d’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetItemState .
TVM_GETLINECOLOR	Le message TVM_GETLINECOLOR obtient la couleur de ligne actuelle.
TVM_GETNEXTITEM	Récupère l’élément d’arborescence qui porte la relation spécifiée avec un élément spécifié. Vous pouvez envoyer ce message explicitement à l’aide de la macro TreeView_GetNextItem .
TVM_GETSCROLLTIME	Récupère la durée de défilement maximale du contrôle d’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetScrollTime .
TVM_GETSELECTEDCOUNT	Non implémenté.
TVM_GETTEXTCOLOR	Récupère la couleur du texte actuel du contrôle. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetTextColor .
TVM_GETTOOLTIPS	Récupère le handle du contrôle d’info-bulle enfant utilisé par un contrôle arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetToolTips .
TVM_GETUNICODEFORMAT	Récupère l’indicateur de format de caractères Unicode pour le contrôle. Vous pouvez envoyer ce message explicitement ou utiliser la macro TreeView_GetUnicodeFormat .
TVM_GETVISIBLECOUNT	Obtient le nombre d’éléments qui peuvent être entièrement visibles dans la fenêtre cliente d’un contrôle arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetVisibleCount .
TVM_HITTEST	Détermine l’emplacement du point spécifié par rapport à la zone cliente d’un contrôle arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_HitTest .
TVM_INSERTITEM	Insère un nouvel élément dans un contrôle d’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_InsertItem .
TVM_MAPACCIDTOHTREEITEM	Mappe un ID d’accessibilité à un élément HTREEITEM.
TVM_MAPHTREEITEMTOACCID	Mappe un élément HTREEITEM à un ID d’accessibilité.
TVM_SELECTITEM	Sélectionne l’élément d’arborescence spécifié, fait défiler l’élément dans l’affichage ou redessine l’élément dans le style utilisé pour indiquer la cible d’une opération de glisser-déplacer. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_Select, TreeView_SelectItem ou TreeView_SelectDropTarget .
TVM_SETAUTOSCROLLINFO	Définit les informations utilisées pour déterminer les caractéristiques de défilement automatique. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SetAutoScrollInfo .
TVM_SETBKCOLOR	Définit la couleur d’arrière-plan du contrôle. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SetBkColor .
TVM_SETBORDER	Destiné à un usage interne ; non recommandé pour une utilisation dans les applications. Définit la taille de la bordure pour les éléments d’un contrôle d’arborescence. Vous pouvez envoyer le message explicitement ou à l’aide de la macro TreeView_SetBorder .
TVM_SETEXTENDEDSTYLE	Indique au contrôle d’arborescence de définir des styles étendus. Envoyez ce message ou utilisez la macro TreeView_SetExtendedStyle.
TVM_SETHOT	Destiné à un usage interne ; non recommandé pour une utilisation dans les applications. Définit l’élément actif pour un contrôle d’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SetHot .
TVM_SETIMAGELIST	Définit la liste d’images normales ou d’état pour un contrôle d’arborescence et redessine le contrôle à l’aide des nouvelles images. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SetImageList .
TVM_SETINDENT	Définit la largeur de mise en retrait d’un contrôle d’arborescence et redessine le contrôle pour refléter la nouvelle largeur. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SetIndent .
TVM_SETINSERTMARK	Définit la marque d’insertion dans un contrôle arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SetInsertMark .
TVM_SETINSERTMARKCOLOR	Définit la couleur utilisée pour dessiner la marque d’insertion pour l’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SetInsertMarkColor .
TVM_SETITEM	Le message TVM_SETITEM définit tout ou partie des attributs d’un élément d’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SetItem .
TVM_SETITEMHEIGHT	Définit la hauteur des éléments d’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SetItemHeight .
TVM_SETLINECOLOR	Le message TVM_SETLINECOLOR définit la couleur de ligne actuelle.
TVM_SETSCROLLTIME	Définit la durée de défilement maximale pour le contrôle d’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SetScrollTime .
TVM_SETTEXTCOLOR	Définit la couleur du texte du contrôle. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SetTextColor .
TVM_SETTOOLTIPS	Définit le contrôle d’info-bulle enfant d’un contrôle d’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SetToolTips .
TVM_SETUNICODEFORMAT	Définit l’indicateur de format de caractères Unicode pour le contrôle. Ce message vous permet de modifier le jeu de caractères utilisé par le contrôle au moment de l’exécution plutôt que d’avoir à recréer le contrôle. Vous pouvez envoyer ce message explicitement ou utiliser la macro TreeView_SetUnicodeFormat .
TVM_SHOWINFOTIP	Affiche l’info-bulle d’un élément spécifié dans un contrôle arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_ShowInfoTip ..
TVM_SORTCHILDREN	Trie les éléments enfants de l’élément parent spécifié dans un contrôle arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SortChildren .
TVM_SORTCHILDRENCB	Trie les éléments d’arborescence à l’aide d’une fonction de rappel définie par l’application qui compare les éléments. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SortChildrenCB .

Notifications

Rubrique	Contenu
NM_CLICK (arborescence)	Avertit la fenêtre parente d’un contrôle arborescence que l’utilisateur a cliqué sur le bouton gauche de la souris dans le contrôle. Cette notification est envoyée sous la forme d’un message WM_NOTIFY .
NM_CUSTOMDRAW (arborescence)	Envoyé par un contrôle d’arborescence pour notifier sa fenêtre parente des opérations de dessin. Cette notification est envoyée sous la forme d’un message WM_NOTIFY .
NM_DBLCLK (arborescence)	Avertit la fenêtre parente d’un contrôle arborescence que l’utilisateur a double-cliqué sur le bouton gauche de la souris dans le contrôle. Cette notification est envoyée sous la forme d’un message WM_NOTIFY .
NM_KILLFOCUS (arborescence)	Avertit la fenêtre parente d’un contrôle d’arborescence que le contrôle a perdu le focus d’entrée. Cette notification est envoyée sous la forme d’un message WM_NOTIFY .
NM_RCLICK (arborescence)	Avertit la fenêtre parente d’un contrôle arborescence que l’utilisateur a cliqué sur le bouton droit de la souris dans le contrôle. Cette notification est envoyée sous la forme d’un message WM_NOTIFY .
NM_RDBLCLK (arborescence)	Avertit le parent d’un contrôle arborescence que l’utilisateur a double-cliqué sur le bouton droit de la souris dans le contrôle. Cette notification est envoyée sous la forme d’un message WM_NOTIFY .
NM_RETURN (arborescence)	Avertit la fenêtre parente d’un contrôle arborescence que le contrôle a le focus d’entrée et que l’utilisateur a appuyé sur la touche. Cette notification est envoyée sous la forme d’un message WM_NOTIFY .
NM_SETCURSOR (arborescence)	Avertit la fenêtre parente d’un contrôle arborescence que le contrôle définit le curseur en réponse à un message WM_SETCURSOR . Cette notification est envoyée sous la forme d’un message WM_NOTIFY .
NM_SETFOCUS (arborescence)	Avertit la fenêtre parente d’un contrôle arborescence que le contrôle a reçu le focus d’entrée. Cette notification est envoyée sous la forme d’un message WM_NOTIFY .
TVN_ASYNCDRAW	Envoyé par un contrôle arborescence à son parent lorsque le dessin d’une icône ou d’une superposition a échoué. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_BEGINDRAG	Avertit la fenêtre parente d’un contrôle arborescence qu’une opération de glisser-déplacer impliquant le bouton gauche de la souris est lancée. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_BEGINLABELEDIT	Avertit la fenêtre parente d’un contrôle d’arborescence du début de la modification d’étiquette pour un élément. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_BEGINRDRAG	Avertit la fenêtre parente d’un contrôle arborescence de l’initiation d’une opération de glisser-déplacer impliquant le bouton droit de la souris. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_DELETEITEM	Avertit la fenêtre parente d’un contrôle d’arborescence qu’un élément est en cours de suppression. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_ENDLABELEDIT	Notifie la fenêtre parente d’un contrôle d’arborescence concernant la fin de la modification d’étiquette pour un élément. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_GETDISPINFO	Demande que la fenêtre parente d’un contrôle d’arborescence fournisse les informations nécessaires à l’affichage ou au tri d’un élément. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_GETINFOTIP	Envoyé par un contrôle arborescence qui a le style TVS_INFOTIP . Cette notification est envoyée lorsque le contrôle demande l’affichage d’informations texte supplémentaires dans une info-bulle. La notification est envoyée sous la forme d’un message WM_NOTIFY .
TVN_ITEMCHANGED	Avertit la fenêtre parente d’un contrôle d’arborescence que les attributs d’élément ont été modifiés. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_ITEMCHANGING	Avertit la fenêtre parente d’un contrôle arborescence que les attributs d’élément sont sur le point de changer. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_ITEMEXPANDED	Avertit la fenêtre parente d’un contrôle d’arborescence que la liste d’éléments enfants d’un élément parent a été développée ou réduite. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_ITEMEXPANDING	Avertit la fenêtre parente d’un contrôle arborescence que la liste d’éléments enfants d’un élément parent est sur le point de se développer ou de se réduire. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_KEYDOWN	Avertit la fenêtre parente d’un contrôle d’arborescence que l’utilisateur a appuyé sur une touche et que le contrôle d’arborescence a le focus d’entrée. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_SELCHANGED	Avertit la fenêtre parente d’un contrôle d’arborescence que la sélection a changé d’un élément à un autre. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_SELCHANGING	Avertit la fenêtre parente d’un contrôle d’arborescence que la sélection est sur le point de passer d’un élément à un autre. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_SETDISPINFO	Avertit la fenêtre parente d’un contrôle d’arborescence qu’il doit mettre à jour les informations qu’il conserve sur un élément. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TVN_SINGLEEXPAND	Envoyé par un contrôle arborescence avec le style TVS_SINGLEEXPAND lorsque l’utilisateur ouvre ou ferme un élément d’arborescence en un seul clic de la souris. Cette notification est envoyée sous la forme d’un message WM_NOTIFY .

Structures

Rubrique	Contenu
NMTREEVIEW	Contient des informations sur un code de notification d’arborescence. Cette structure est identique à la structure NM_TREEVIEW , mais elle a été renommée pour suivre les conventions de nommage actuelles.
NMTVASYNCDRAW	Contient une explication de l’échec du dessin d’une icône ou d’un élément d’arborescence de superposition. Cette structure est envoyée sur une notification TVN_ASYNCDRAW . Définissez le membre dwRetFlags pour indiquer l’action que le contrôle doit entreprendre. Notez qu’un dessin peut échouer s’il n’y a pas d’image ; en d’autres termes, lorsque l’image d’icône n’a pas été extraite.
NMTVCUSTOMDRAW	Contient des informations spécifiques à un code de notification NM_CUSTOMDRAW (arborescence) envoyé par un contrôle d’arborescence.
NMTVDISPINFO	Contient et reçoit des informations d’affichage pour un élément d’arborescence. Cette structure est identique à la structure TV_DISPINFO , mais elle a été renommée pour suivre les conventions de nommage actuelles.
NMTVDISPINFOEX	Contient des informations relatives aux informations de notification TreeView étendues.
NMTVGETINFOTIP	Contient et reçoit les informations d’élément d’arborescence nécessaires à l’affichage d’une info-bulle pour un élément. Cette structure est utilisée avec le code de notification TVN_GETINFOTIP .
NMTVITEMCHANGE	Contient des informations sur une modification d’élément d’arborescence. Cette structure est envoyée avec les notifications TVN_ITEMCHANGED et TVN_ITEMCHANGING .
NMTVITEMRECT	Actuellement non pris en charge.
NMTVKEYDOWN	Contient des informations sur un événement de clavier dans un contrôle arborescence. Cette structure est utilisée avec le code de notification TVN_KEYDOWN . La structure est identique à la structure TV_KEYDOWN , mais elle a été renommée pour suivre les conventions de nommage actuelles.
NMTVSTATEIMAGECHANGING	Contient des informations sur le code de notification d’une image d’état d’arborescence.
TVGETITEMPARTRECTINFO	Contient des informations permettant d’identifier la « zone d’accès » pour une partie spécifiée d’un élément d’arborescence. La structure est utilisée avec le message TVM_GETITEMPARTRECT et la macro TreeView_GetItemPartRect .
TVHITTESTINFO	Contient les informations utilisées pour déterminer l’emplacement d’un point par rapport à un contrôle arborescence. Cette structure est utilisée avec le message TVM_HITTEST . La structure est identique à la structure TV_HITTESTINFO , mais elle a été renommée pour suivre les conventions de nommage actuelles.
TVINSERTSTRUCT	Contient les informations utilisées pour ajouter un nouvel élément à un contrôle arborescence. Cette structure est utilisée avec le message TVM_INSERTITEM . La structure est identique à la structure TV_INSERTSTRUCT , mais elle a été renommée pour suivre les conventions de nommage actuelles.
TVITEM	Spécifie ou reçoit les attributs d’un élément d’arborescence. Cette structure est identique à la structure TV_ITEM , mais elle a été renommée pour suivre les conventions de nommage actuelles. Les nouvelles applications doivent utiliser cette structure.
TVITEMEX	Spécifie ou reçoit les attributs d’un élément d’arborescence. Cette structure est une amélioration de la structure TVITEM . Les nouvelles applications doivent utiliser cette structure le cas échéant.
TVSORTCB	Contient les informations utilisées pour trier les éléments enfants dans un contrôle arborescence. Cette structure est utilisée avec le message TVM_SORTCHILDRENCB . Cette structure est identique à la structure TV_SORTCB , mais elle a été renommée pour suivre les conventions de nommage actuelles.

Constantes

Rubrique	Contenu
Styles étendus de contrôle d’arborescence	Cette section répertorie les styles étendus utilisés lors de la création de contrôles d’arborescence. La valeur des styles étendus est une combinaison de ces styles au niveau du bit.
États de l’élément de contrôle Tree-View	Cette section répertorie les indicateurs d’état d’élément utilisés pour indiquer l’état d’un élément dans un contrôle arborescence.
Styles de fenêtre de contrôle d’arborescence	Cette section répertorie les styles de fenêtre utilisés lors de la création de contrôles d’arborescence.