Arborescence
Cette section contient des informations sur les éléments de programmation utilisés avec les contrôles d’arborescence.
Aperçus
| Sujet | 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, comme les en-têtes d’un document, les entrées d’un index ou les fichiers et répertoires sur un disque. |
| utiliser des contrôles Tree-View | Cette section contient des détails d’implémentation et un exemple de code permettant d’utiliser des contrôles d’arborescence. |
Macros
| Sujet | 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 lors du glissement de l’élément à l’aide des fonctions de liste d’images. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_CREATEDRAGIMAGE. |
| TreeView_DeleteAllItems | Supprime tous les éléments d’un contrôle d’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 à ligne unique contenant le texte. Cette macro sélectionne et concentre implicitement l’élément spécifié. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_EDITLABEL. |
| TreeView_EndEditLabelNow | Termine la modification de l’étiquette d’un élément d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_ENDEDITLABELNOW. |
| TreeView_EnsureVisible | Garantit qu’un élément d’arborescence est visible, développez l’élément parent ou faites défiler le contrôle d’arborescence, si nécessaire. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_ENSUREVISIBLE. |
| 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 explicitement le message TVM_EXPAND. |
| TreeView_GetBkColor | Récupère la couleur d’arrière-plan actuelle du contrôle. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETBKCOLOR. |
| TreeView_GetCheckState | Obtient l’état de vérification de l’élément spécifié. Vous pouvez également utiliser le message TVM_GETITEMSTATE directement. |
| 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 de 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 explicitement le message TVM_GETCOUNT. |
| 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 de 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 explicitement le message TVM_GETEDITCONTROL. |
| TreeView_GetExtendedStyle | Récupère le style étendu d’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 d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur de 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 explicitement le message TVM_GETIMAGELIST. |
| TreeView_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 utiliser cette macro ou envoyer explicitement le message TVM_GETINDENT. |
| 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 explicitement le message TVM_GETINSERTMARKCOLOR. |
| TreeView_GetISearchString | Récupère la chaîne de recherche incrémentielle pour un contrôle d’arborescence. Le contrôle d’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 explicitement le message TVM_GETISEARCHSTRING. |
| TreeView_GetItem | Récupère un ou plusieurs attributs d’un élément d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETITEM. |
| TreeView_GetItemHeight | Récupère la hauteur actuelle des éléments d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETITEMHEIGHT. |
| 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 explicitement le message TVM_GETITEMPARTRECT. |
| 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 explicitement le message TVM_GETITEMRECT. |
| TreeView_GetItemState | Récupère un ou plusieurs attributs d’état d’un élément d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETITEMSTATE. |
| TreeView_GetLastVisible | Récupère le dernier élément développé dans un contrôle d’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 de 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 à un élément spécifié. Vous pouvez utiliser cette macro, utiliser l’une des macros TreeView_Get décrites ci-dessous ou envoyer explicitement le message TVM_GETNEXTITEM. |
| 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 d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur de TVGN_NEXT. |
| TreeView_GetNextVisible | Récupère l’élément visible suivant un élément spécifié dans un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur de 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 de 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 d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur de 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 d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur de TVGN_PREVIOUSVISIBLE. |
| TreeView_GetRoot | Récupère le premier 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 de TVGN_ROOT. |
| TreeView_GetScrollTime | Récupère la durée de défilement maximale pour le contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETSCROLLTIME. |
| TreeView_GetSelectedCount | Non implémenté. |
| TreeView_GetSelection | Récupère l’élément actuellement sélectionné dans un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETNEXTITEM avec l’indicateur de TVGN_CARET. |
| TreeView_GetTextColor | Récupère la couleur de texte actuelle du contrôle. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETTEXTCOLOR. |
| TreeView_GetToolTips | Récupère le handle dans le contrôle d’info-bulle enfant utilisé par un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETTOOLTIPS. |
| TreeView_GetUnicodeFormat | Récupère l’indicateur de format de caractère Unicode pour le contrôle. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETUNICODEFORMAT. |
| TreeView_GetVisibleCount | Obtient le nombre d’éléments qui peuvent être entièrement visibles dans la fenêtre cliente d’un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_GETVISIBLECOUNT. |
| TreeView_HitTest | Détermine l’emplacement du point spécifié par rapport à la zone cliente d’un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_HITTEST. |
| TreeView_InsertItem | Insère un nouvel élément dans un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_INSERTITEM. |
| TreeView_MapAccIDToHTREEITEM | Mappe un ID d’accessibilité à un HTREEITEM. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_MAPACCIDTOHTREEITEM. |
| TreeView_MapHTREEITEMtoAccID | Mappe un HTREEITEM à un ID d’accessibilité. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_MAPHTREEITEMTOACCID. |
| 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 le TreeView_SelectItem, TreeView_SelectSetFirstVisibleou TreeView_SelectDropTarget macros, ou envoyer explicitement le message TVM_SELECTITEM. |
| TreeView_SelectDropTarget | Redessine un élément de contrôle tree-view 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 envoyer explicitement le message TVM_SELECTITEM. |
| TreeView_SelectItem | Sélectionne l’élément d’arborescence spécifié. Vous pouvez utiliser cette macro ou la macro TreeView_Select, ou envoyer explicitement le message TVM_SELECTITEM. |
| TreeView_SelectSetFirstVisible | Fait défiler le contrôle d’arborescence verticalement pour vous 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 envoyer explicitement le message TVM_SELECTITEM. |
| 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 explicitement le message TVM_SETBKCOLOR. |
| TreeView_SetBorder |
destiné à une utilisation interne ; non recommandé pour une utilisation dans les applications. Définit la taille de la bordure des éléments dans un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_SETBORDER. |
| TreeView_SetCheckState | Définit l’image d’état de l’élément sur « coché » ou « décochée ». Vous pouvez également utiliser directement le message TVM_SETITEM. |
| 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 actif pour un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_SETHOT. |
| TreeView_SetImageList | Définit la liste d’images normale 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 explicitement le message TVM_SETIMAGELIST. |
| 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 explicitement le message TVM_SETINDENT. |
| TreeView_SetInsertMark | Définit la marque d’insertion dans un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_SETINSERTMARK. |
| TreeView_SetInsertMarkColor | Définit la couleur utilisée pour dessiner la marque d’insertion de l’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_SETINSERTMARKCOLOR. |
| TreeView_SetItem | La macro TreeView_SetItem définit certains ou tous les attributs d’un élément d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_SETITEM. |
| TreeView_SetItemHeight | Définit la hauteur des éléments d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_SETITEMHEIGHT. |
| TreeView_SetItemState | Définit les attributs d’état d’un élément d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_SETITEM. |
| TreeView_SetLineColor | Définit la couleur de ligne actuelle. Vous pouvez également utiliser directement le message TVM_SETLINECOLOR. |
| TreeView_SetScrollTime | Définit la durée de défilement maximale pour le contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_SETSCROLLTIME. |
| TreeView_SetTextColor | Définit la couleur du texte du contrôle. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_SETTEXTCOLOR. |
| TreeView_SetToolTips | Définit le contrôle d’info-bulle enfant d’un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_SETTOOLTIPS. |
| TreeView_SetUnicodeFormat | Définit l’indicateur de format de caractère 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 de devoir recréer le contrôle. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_SETUNICODEFORMAT. |
| TreeView_ShowInfoTip | Affiche l’info-bulle d’un élément spécifié dans un contrôle d’arborescence. Utilisez cette macro ou envoyez explicitement le message TVM_SHOWINFOTIP. |
| TreeView_SortChildren | Trie les éléments enfants de l’élément parent spécifié dans un contrôle d’arborescence. Vous pouvez utiliser cette macro ou envoyer explicitement le message TVM_SORTCHILDREN. |
| 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 explicitement le message TVM_SORTCHILDRENCB. |
Messages
| Sujet | Contenu |
|---|---|
| TVM_CREATEDRAGIMAGE | Crée une bitmap de glissement pour l’élément spécifié dans un contrôle d’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 glissement 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 d’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 d’édition à ligne unique 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, développez l’élément parent ou faites 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 un nombre d’éléments dans un contrôle d’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 d’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 d’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 d’arborescence. Le contrôle d’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 un ou plusieurs 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 un ou plusieurs 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 à 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 pour le 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 de texte actuelle du contrôle. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetTextColor. |
| TVM_GETTOOLTIPS | Récupère le handle dans le contrôle d’info-bulle enfant utilisé par un contrôle d’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ère 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 d’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 d’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 HTREEITEM. |
| TVM_MAPHTREEITEMTOACCID | Mappe un 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_SelectItemou 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é à une utilisation interne ; non recommandé pour une utilisation dans les applications. Définit la taille de la bordure des éléments dans un contrôle d’arborescence. Vous pouvez envoyer le message explicitement ou à l’aide de la macro TreeView_SetBorder. |
| TVM_SETEXTENDEDSTYLE | Informe le contrôle d’arborescence pour définir des styles étendus. Envoyez ce message ou utilisez la macro TreeView_SetExtendedStyle. |
| TVM_SETHOT |
destiné à une utilisation 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 normale 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 d’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 de l’arborescence. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_SetInsertMarkColor. |
| TVM_SETITEM | Le message TVM_SETITEM définit certains attributs ou tous les 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ère 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 de devoir 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 d’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 d’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
| Sujet | Contenu |
|---|---|
| NM_CLICK (arborescence) | Avertit la fenêtre parente d’un contrôle d’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 informer 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 d’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 d’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 d’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 d’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 d’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 d’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 d’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 d’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 concernant le 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 d’arborescence concernant 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 supprimé. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY. |
| TVN_ENDLABELEDIT | Avertit 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 des 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 d’arborescence qui a le style TVS_INFOTIP. Cette notification est envoyée lorsque le contrôle demande des informations de texte supplémentaires à afficher 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 changé. 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 d’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 des é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 d’arborescence que la liste des éléments enfants d’un élément parent est sur le point de se développer ou de 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 d’arborescence avec le style TVS_SINGLEEXPAND lorsque l’utilisateur ouvre ou ferme un élément d’arborescence à l’aide d’un simple clic de la souris. Cette notification est envoyée sous la forme d’un message WM_NOTIFY. |
Structures
| Sujet | 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 d’affectation de noms actuelles. |
| NMTVASYNCDRAW | Contient une explication de la raison pour laquelle le dessin d’une icône ou d’un élément d’arborescence de superposition a échoué. 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 NM_CUSTOMDRAW (arborescence) code de notification 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 d’affectation de noms actuelles. |
| NMTVDISPINFOEX | Contient des informations relatives aux informations de notification TreeView étendues. |
| NMTVGETINFOTIP | Contient et reçoit des informations d’élément d’arborescence nécessaires pour afficher 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 | Non pris en charge actuellement. |
| NMTVKEYDOWN | Contient des informations sur un événement de clavier dans un contrôle d’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 d’affectation de noms actuelles. |
| NMTVSTATEIMAGECHANGING | Contient des informations sur une image d’état d’arborescence modifiant le code de notification. |
| 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 des informations utilisées pour déterminer l’emplacement d’un point par rapport à un contrôle d’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 d’affectation de noms actuelles. |
| TVINSERTSTRUCT | Contient des informations utilisées pour ajouter un nouvel élément à un contrôle d’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 d’affectation de noms actuelles. |
| TVITEM | Spécifie ou reçoit des 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 d’affectation de noms actuelles. Les nouvelles applications doivent utiliser cette structure. |
| TVITEMEX | Spécifie ou reçoit des attributs d’un élément d’arborescence. Cette structure est une amélioration de la structureTVITEM. Les nouvelles applications doivent utiliser cette structure, le cas échéant. |
| TVSORTCB | Contient des informations utilisées pour trier les éléments enfants dans un contrôle d’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 d’affectation de noms actuelles. |
Constantes
| Sujet | Contenu |
|---|---|
| styles étendus de contrôle Tree-View | 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 au niveau du bit de ces styles. |
| États d’é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 d’arborescence. |
| styles de fenêtre de contrôle Tree-View | Cette section répertorie les styles de fenêtre utilisés lors de la création de contrôles d’arborescence. |