Zone de liste modifiable (contrôles Windows)

  • Article

Cette section contient des informations sur les éléments de programmation utilisés avec les zones de liste déroulante. Une zone de liste modifiable est un type unique de contrôle, défini par la classe COMBOBOX, qui combine une grande partie des fonctionnalités d’une zone de liste et d’un contrôle d’édition.

Vues d'ensemble

Rubrique Contenu
À propos des zones de liste modifiable Cette section décrit les différents types de zones de liste déroulante.
Fonctionnalités de zone de liste modifiable Ce document décrit les fonctionnalités de la zone de liste déroulante.
Utilisation de zones de liste déroulante Les exemples de code de cette section montrent comment effectuer des tâches associées aux zones de liste déroulante.

Fonctions

Rubrique Contenu
DlgDirListComboBox Remplace le contenu d’une zone de liste déroulante par les noms des sous-répertoires et fichiers dans un répertoire spécifié. Vous pouvez filtrer la liste des noms en spécifiant un ensemble d’attributs de fichier. La liste des noms peut inclure des lettres de lecteur mappées.
DlgDirSelectComboBoxEx Récupère la sélection actuelle à partir d’une zone de liste modifiable remplie à l’aide de la fonction DlgDirListComboBox . La sélection est interprétée comme une lettre de lecteur, un fichier ou un nom de répertoire.
GetComboBoxInfo Récupère des informations sur la zone de liste modifiable spécifiée.

Macros

Rubrique Contenu
ComboBox_AddItemData Ajoute des données d’élément à la liste dans une zone de liste déroulante à l’emplacement spécifié. Vous pouvez utiliser cette macro ou envoyer le message CB_ADDSTRING explicitement.
ComboBox_AddString Ajoute une chaîne à une liste dans une zone de liste déroulante. Si la zone de liste déroulante n’a pas le style CBS_SORT , la chaîne est ajoutée à la fin de la liste. Sinon, la chaîne est insérée dans la liste et la liste est triée. Vous pouvez utiliser cette macro ou envoyer le message CB_ADDSTRING explicitement.
ComboBox_DeleteString Supprime l’élément à l’emplacement spécifié dans une liste dans une zone de liste déroulante. Vous pouvez utiliser cette macro ou envoyer explicitement le message CB_DELETESTRING .
ComboBox_Dir Ajoute des noms à la liste affichée par une zone de liste déroulante. La macro ajoute les noms des répertoires et des fichiers qui correspondent à une chaîne et un ensemble d’attributs de fichier spécifiés. Il peut également ajouter des lettres de lecteur mappées à la liste dans une zone de liste déroulante. Vous pouvez utiliser cette macro ou envoyer explicitement le message CB_DIR .
ComboBox_Enable Active ou désactive un contrôle de zone de liste modifiable.
ComboBox_FindItemData Recherche le premier élément dans une liste de zone de liste déroulante qui contient les données d’élément spécifiées. Vous pouvez utiliser cette macro ou envoyer explicitement le message CB_FINDSTRING .
ComboBox_FindString Recherche la première chaîne dans une liste de zones de liste déroulante qui commence par la chaîne spécifiée. Vous pouvez utiliser cette macro ou envoyer explicitement le message CB_FINDSTRING .
ComboBox_FindStringExact Recherche la première chaîne dans une liste de zones de liste déroulante qui correspond exactement à la chaîne spécifiée, sauf que la recherche ne respecte pas la casse. Vous pouvez utiliser cette macro ou envoyer le message CB_FINDSTRINGEXACT explicitement.
ComboBox_GetCount Obtient le nombre d’éléments dans la zone de liste d’une zone de liste modifiable. Vous pouvez utiliser cette macro ou envoyer le message CB_GETCOUNT explicitement.
ComboBox_GetCueBannerText Obtient le texte de bannière d’indicateur affiché dans le contrôle d’édition d’une zone de liste déroulante. Utilisez cette macro ou envoyez le message CB_GETCUEBANNER explicitement.
ComboBox_GetCurSel Obtient l’index de l’élément actuellement sélectionné dans une zone de liste déroulante. Vous pouvez utiliser cette macro ou envoyer le message CB_GETCURSEL explicitement.
ComboBox_GetDroppedControlRect Récupère les coordonnées d’écran d’une zone de liste déroulante dans son état supprimé. Vous pouvez utiliser cette macro ou envoyer le message CB_GETDROPPEDCONTROLRECT explicitement.
ComboBox_GetDroppedState Vérifie si la liste déroulante d’un contrôle de zone de liste déroulante est visible. Vous pouvez utiliser cette macro ou envoyer le message CB_GETDROPPEDSTATE explicitement.
ComboBox_GetExtendedUI Détermine si une zone de liste déroulante utilise l’interface utilisateur par défaut ou l’interface utilisateur étendue. Vous pouvez utiliser cette macro ou envoyer le message CB_GETEXTENDEDUI explicitement.
ComboBox_GetItemData Obtient la valeur définie par l’application associée à l’élément de liste spécifié dans une zone de liste modifiable. Vous pouvez utiliser cette macro ou envoyer le message CB_GETITEMDATA explicitement.
ComboBox_GetItemHeight Récupère la hauteur des éléments de liste dans une zone de liste modifiable. Vous pouvez utiliser cette macro ou envoyer le message CB_GETITEMHEIGHT explicitement.
ComboBox_GetLBText Obtient une chaîne d’une liste dans une zone de liste modifiable. Vous pouvez utiliser cette macro ou envoyer le message CB_GETLBTEXT explicitement.
ComboBox_GetLBTextLen Obtient la longueur d’une chaîne dans la liste dans une zone de liste déroulante. Vous pouvez utiliser cette macro ou envoyer le message CB_GETLBTEXTLEN explicitement.
ComboBox_GetMinVisible Obtient le nombre minimal d’éléments visibles dans la liste déroulante d’une zone de liste déroulante.
ComboBox_GetText Récupère le texte d’un contrôle de zone de liste modifiable.
ComboBox_GetTextLength Obtient le nombre de caractères dans le texte d’une zone de liste déroulante.
ComboBox_InsertItemData Insère des données d’élément dans une liste dans une zone de liste déroulante à l’emplacement spécifié. Vous pouvez utiliser cette macro ou envoyer le message CB_INSERTSTRING explicitement.
ComboBox_InsertString Ajoute une chaîne à une liste dans une zone de liste déroulante à l’emplacement spécifié. Vous pouvez utiliser cette macro ou envoyer le message CB_INSERTSTRING explicitement.
ComboBox_LimitText Limite la longueur du texte que l’utilisateur peut taper dans le contrôle d’édition d’une zone de liste déroulante. Vous pouvez utiliser cette macro ou envoyer le message CB_LIMITTEXT explicitement.
ComboBox_ResetContent Supprime tous les éléments de la zone de liste et le contrôle de modification d’une zone de liste modifiable. Vous pouvez utiliser cette macro ou envoyer le message CB_RESETCONTENT explicitement.
ComboBox_SelectItemData Recherche dans une liste dans une zone de liste modifiable un élément qui contient les données d’élément spécifiées. Si un élément correspondant est trouvé, l’élément est sélectionné. Vous pouvez utiliser cette macro ou envoyer le message CB_SELECTSTRING explicitement.
ComboBox_SelectString Recherche dans une liste dans une zone de liste modifiable un élément qui commence par les caractères d’une chaîne spécifiée. Si un élément correspondant est trouvé, l’élément est sélectionné. Vous pouvez utiliser cette macro ou envoyer le message CB_SELECTSTRING explicitement.
ComboBox_SetCueBannerText Définit le texte de bannière de repère affiché pour le contrôle d’édition d’une zone de liste déroulante.
ComboBox_SetCurSel Définit l’élément actuellement sélectionné dans une zone de liste déroulante. Vous pouvez utiliser cette macro ou envoyer le message CB_SETCURSEL explicitement.
ComboBox_SetExtendedUI Sélectionne l’interface utilisateur par défaut ou l’interface utilisateur étendue pour une zone de liste déroulante qui a le style CBS_DROPDOWN ou CBS_DROPDOWNLIST . Vous pouvez utiliser cette macro ou envoyer le message CB_SETEXTENDEDUI explicitement.
ComboBox_SetItemData Définit la valeur définie par l’application associée à l’élément de liste spécifié dans une zone de liste modifiable. Vous pouvez utiliser cette macro ou envoyer le message CB_SETITEMDATA explicitement.
ComboBox_SetItemHeight Définit la hauteur des éléments de liste ou le champ de sélection dans une zone de liste déroulante. Vous pouvez utiliser cette macro ou envoyer le message CB_SETITEMHEIGHT explicitement.
ComboBox_SetMinVisible Définit le nombre minimal d’éléments visibles dans la liste déroulante d’une zone de liste déroulante.
ComboBox_SetText Définit le texte d’une zone de liste modifiable.
ComboBox_ShowDropdown Affiche ou masque la liste dans une zone de liste déroulante. Vous pouvez utiliser cette macro ou envoyer le message CB_SHOWDROPDOWN explicitement.

Messages

Rubrique Contenu
CB_ADDSTRING Ajoute une chaîne à la zone de liste d’une zone de liste modifiable. Si la zone de liste déroulante n’a pas le style CBS_SORT , la chaîne est ajoutée à la fin de la liste. Sinon, la chaîne est insérée dans la liste et la liste est triée.
CB_DELETESTRING Supprime une chaîne dans la zone de liste d’une zone de liste modifiable.
CB_DIR Ajoute des noms à la liste affichée par la zone de liste déroulante. Le message ajoute les noms des répertoires et des fichiers qui correspondent à une chaîne et à un ensemble d’attributs de fichier spécifiés. CB_DIR pouvez également ajouter des lettres de lecteur mappées à la liste.
CB_FINDSTRING Recherche dans la zone de liste d’une zone de liste modifiable un élément commençant par les caractères d’une chaîne spécifiée.
CB_FINDSTRINGEXACT Recherche la première chaîne de zone de liste dans une zone de liste modifiable qui correspond à la chaîne spécifiée dans le paramètre lParam .
CB_GETCOMBOBOXINFO Obtient des informations sur la zone de liste déroulante spécifiée.
CB_GETCOUNT Obtient le nombre d’éléments dans la zone de liste d’une zone de liste modifiable.
CB_GETCUEBANNER Obtient le texte de bannière de repère affiché dans le contrôle d’édition d’une zone de liste déroulante. Envoyez ce message explicitement ou à l’aide de la macro ComboBox_GetCueBannerText .
CB_GETCURSEL Une application envoie un message CB_GETCURSEL pour récupérer l’index de l’élément actuellement sélectionné, le cas échéant, dans la zone de liste d’une zone de liste modifiable.
CB_GETDROPPEDCONTROLRECT Une application envoie un message CB_GETDROPPEDCONTROLRECT pour récupérer les coordonnées d’écran d’une zone de liste déroulante dans son état supprimé.
CB_GETDROPPEDSTATE Détermine si la zone de liste d’une zone de liste modifiable est supprimée.
CB_GETDROPPEDWIDTH Obtient la largeur minimale autorisée, en pixels, de la zone de liste d’une zone de liste modifiable avec le style CBS_DROPDOWN ou CBS_DROPDOWNLIST .
CB_GETEDITSEL Obtient les positions de caractères de début et de fin de la sélection actuelle dans le contrôle d’édition d’une zone de liste déroulante.
CB_GETEXTENDEDUI Détermine si une zone de liste déroulante a l’interface utilisateur par défaut ou l’interface utilisateur étendue.
CB_GETHORIZONTALEXTENT Obtient la largeur, en pixels, que la zone de liste peut faire défiler horizontalement (largeur de défilement). Cela s’applique uniquement si la zone de liste a une barre de défilement horizontale.
CB_GETITEMDATA Une application envoie un message CB_GETITEMDATA à une zone de liste déroulante pour récupérer la valeur fournie par l’application associée à l’élément spécifié dans la zone de liste déroulante.
CB_GETITEMHEIGHT Détermine la hauteur des éléments de liste ou le champ de sélection dans une zone de liste modifiable.
CB_GETLBTEXT Obtient une chaîne à partir de la liste d’une zone de liste modifiable.
CB_GETLBTEXTLEN Obtient la longueur, en caractères, d’une chaîne dans la liste d’une zone de liste modifiable.
CB_GETLOCALE Obtient les paramètres régionaux actuels de la zone de liste déroulante. Les paramètres régionaux sont utilisés pour déterminer l’ordre de tri correct du texte affiché pour les zones de liste déroulante avec le style CBS_SORT et le texte ajoutés à l’aide du message CB_ADDSTRING .
CB_GETMINVISIBLE Obtient le nombre minimal d’éléments visibles dans la liste déroulante d’une zone de liste déroulante.
CB_GETTOPINDEX Une application envoie le message CB_GETTOPINDEX pour récupérer l’index de base zéro du premier élément visible dans la partie zone de liste d’une zone de liste modifiable. Initialement, l’élément avec l’index 0 se trouve en haut de la zone de liste, mais si le contenu de la zone de liste a été fait défiler, un autre élément peut se trouver en haut.
CB_INITSTORAGE Une application envoie le message CB_INITSTORAGE avant d’ajouter un grand nombre d’éléments à la partie zone de liste d’une zone de liste modifiable. Ce message alloue de la mémoire pour le stockage des éléments de zone de liste.
CB_INSERTSTRING Insère une chaîne ou des données d’élément dans la liste d’une zone de liste modifiable. Contrairement au message CB_ADDSTRING , le message CB_INSERTSTRING n’entraîne pas le tri d’une liste avec le style CBS_SORT .
CB_LIMITTEXT Limite la longueur du texte que l’utilisateur peut taper dans le contrôle d’édition d’une zone de liste déroulante.
CB_RESETCONTENT Supprime tous les éléments de la zone de liste et le contrôle de modification d’une zone de liste modifiable.
CB_SELECTSTRING Recherche dans la liste d’une zone de liste déroulante un élément qui commence par les caractères d’une chaîne spécifiée. Si un élément correspondant est trouvé, il est sélectionné et copié dans le contrôle d’édition.
CB_SETCUEBANNER Définit le texte de bannière de signe qui s’affiche pour le contrôle d’édition d’une zone de liste déroulante.
CB_SETCURSEL Une application envoie un message CB_SETCURSEL pour sélectionner une chaîne dans la liste d’une zone de liste déroulante. Si nécessaire, la liste fait défiler la chaîne dans l’affichage. Le texte du contrôle d’édition de la zone de liste modifiable est modifié pour refléter la nouvelle sélection, et toute sélection précédente dans la liste est supprimée.
CB_SETDROPPEDWIDTH Une application envoie le message CB_SETDROPPEDWIDTH pour définir la largeur maximale autorisée, en pixels, de la zone de liste d’une zone de liste modifiable avec le style CBS_DROPDOWN ou CBS_DROPDOWNLIST .
CB_SETEDITSEL Une application envoie un message CB_SETEDITSEL pour sélectionner des caractères dans le contrôle d’édition d’une zone de liste déroulante.
CB_SETEXTENDEDUI Une application envoie un message CB_SETEXTENDEDUI pour sélectionner l’interface utilisateur par défaut ou l’interface utilisateur étendue d’une zone de liste déroulante qui a le style CBS_DROPDOWN ou CBS_DROPDOWNLIST .
CB_SETHORIZONTALEXTENT Une application envoie le message CB_SETHORIZONTALEXTENT pour définir la largeur, en pixels, par laquelle une zone de liste peut être défilé horizontalement (largeur de défilement). Si la largeur de la zone de liste est inférieure à cette valeur, la barre de défilement horizontale fait défiler horizontalement les éléments de la zone de liste. Si la largeur de la zone de liste est égale ou supérieure à cette valeur, la barre de défilement horizontale est masquée ou, si la zone de liste déroulante a le style CBS_DISABLENOSCROLL , désactivée.
CB_SETITEMDATA Une application envoie un message CB_SETITEMDATA pour définir la valeur associée à l’élément spécifié dans une zone de liste déroulante.
CB_SETITEMHEIGHT Une application envoie un message CB_SETITEMHEIGHT pour définir la hauteur des éléments de liste ou du champ de sélection dans une zone de liste déroulante.
CB_SETLOCALE Une application envoie un message CB_SETLOCALE pour définir les paramètres régionaux actuels de la zone de liste déroulante. Si la zone de liste déroulante a le style CBS_SORT et que des chaînes sont ajoutées à l’aide de CB_ADDSTRING, les paramètres régionaux d’une zone de liste modifiable affectent la façon dont les éléments de liste sont triés.
CB_SETMINVISIBLE Une application envoie un message CB_SETMINVISIBLE pour définir le nombre minimal d’éléments visibles dans la liste déroulante d’une zone de liste déroulante.
CB_SETTOPINDEX Une application envoie le message CB_SETTOPINDEX pour s’assurer qu’un élément particulier est visible dans la zone de liste d’une zone de liste déroulante. Le système fait défiler le contenu de la zone de liste afin que l’élément spécifié apparaisse en haut de la zone de liste ou que la plage de défilement maximale ait été atteinte.
CB_SHOWDROPDOWN Une application envoie un message CB_SHOWDROPDOWN pour afficher ou masquer la zone de liste d’une zone de liste déroulante qui a le style CBS_DROPDOWN ou CBS_DROPDOWNLIST .

Notifications

Rubrique Contenu
CBN_CLOSEUP Le code de notification CBN_CLOSEUP est envoyé lorsque la zone de liste d’une zone de liste modifiable a été fermée. La fenêtre parente de la zone de liste déroulante reçoit ce code de notification via le message WM_COMMAND .
CBN_DBLCLK Le code de notification CBN_DBLCLK est envoyé lorsque l’utilisateur double-clique sur une chaîne dans la zone de liste d’une zone de liste déroulante. La fenêtre parente de la zone de liste déroulante reçoit ce code de notification via le message WM_COMMAND .
CBN_DROPDOWN Le code de notification CBN_DROPDOWN est envoyé lorsque la zone de liste d’une zone de liste modifiable est sur le point d’être rendue visible. La fenêtre parente de la zone de liste déroulante reçoit ce code de notification via le message WM_COMMAND .
CBN_EDITCHANGE Le code de notification CBN_EDITCHANGE est envoyé après que l’utilisateur a effectué une action qui a peut-être modifié le texte dans la partie contrôle d’édition d’une zone de liste déroulante. Contrairement au code de notification CBN_EDITUPDATE , ce code de notification est envoyé après que le système a mis à jour l’écran. La fenêtre parente de la zone de liste déroulante reçoit ce code de notification via le message WM_COMMAND .
CBN_EDITUPDATE Le code de notification CBN_EDITUPDATE est envoyé lorsque la partie de contrôle d’édition d’une zone de liste déroulante est sur le point d’afficher du texte modifié. Ce code de notification est envoyé après que le contrôle a mis en forme le texte, mais avant d’afficher le texte. La fenêtre parente de la zone de liste déroulante reçoit ce code de notification via le message WM_COMMAND .
CBN_ERRSPACE Le code de notification CBN_ERRSPACE est envoyé lorsqu’une zone de liste modifiable ne peut pas allouer suffisamment de mémoire pour répondre à une demande spécifique. La fenêtre parente de la zone de liste déroulante reçoit ce code de notification via le message WM_COMMAND .
CBN_KILLFOCUS Le code de notification CBN_KILLFOCUS est envoyé lorsqu’une zone de liste déroulante perd le focus clavier. La fenêtre parente de la zone de liste déroulante reçoit ce code de notification via le message WM_COMMAND .
CBN_SELCHANGE Le code de notification CBN_SELCHANGE est envoyé lorsque l’utilisateur modifie la sélection actuelle dans la zone de liste d’une zone de liste déroulante. L’utilisateur peut modifier la sélection en cliquant dans la zone de liste ou en utilisant les touches de direction. La fenêtre parente de la zone de liste déroulante reçoit cette notification sous la forme d’un message WM_COMMAND avec CBN_SELCHANGE dans le mot d’ordre supérieur du paramètre wParam .
CBN_SELENDCANCEL Le code de notification CBN_SELENDCANCEL est envoyé lorsque l’utilisateur sélectionne un élément, puis sélectionne un autre contrôle ou ferme la boîte de dialogue. Elle indique que la sélection initiale de l’utilisateur doit être ignorée. La fenêtre parente de la zone de liste déroulante reçoit ce code de notification via le message WM_COMMAND .
CBN_SELENDOK Le code de notification CBN_SELENDOK est envoyé lorsque l’utilisateur sélectionne un élément de liste, ou sélectionne un élément, puis ferme la liste. Elle indique que la sélection de l’utilisateur doit être traitée. La fenêtre parente de la zone de liste déroulante reçoit ce code de notification via le message WM_COMMAND .
CBN_SETFOCUS Le code de notification CBN_SETFOCUS est envoyé lorsqu’une zone de liste modifiable reçoit le focus clavier. La fenêtre parente de la zone de liste déroulante reçoit ce code de notification via le message WM_COMMAND .
WM_COMPAREITEM Le système envoie le message WM_COMPAREITEM pour déterminer la position relative d’un nouvel élément dans la liste triée d’une zone de liste déroulante ou d’une zone de liste dessinée par le propriétaire. Chaque fois que l’application ajoute un nouvel élément, le système envoie ce message au propriétaire d’une zone de liste déroulante ou d’une zone de liste créée avec le style CBS_SORT ou LBS_SORT .
WM_DRAWITEM Le message WM_DRAWITEM est envoyé à la fenêtre parente d’un bouton, d’une zone de liste déroulante, d’une zone de liste ou d’un menu dessiné par le propriétaire lorsqu’un aspect visuel du bouton, de la zone de liste déroulante, de la zone de liste ou du menu a changé.
WM_MEASUREITEM Le message WM_MEASUREITEM est envoyé à la fenêtre propriétaire d’une zone de liste déroulante, d’une zone de liste, d’un contrôle d’affichage de liste ou d’un élément de menu lors de la création du contrôle ou du menu.

Structures

Rubrique Contenu
COMBOBOXINFO Contient des informations status zone de liste déroulante.
COMPAREITEMSTRUCT Fournit les identificateurs et les données fournies par l’application pour deux éléments dans une zone de liste ou une zone de liste déroulante triée et dessinée par le propriétaire.
DRAWITEMSTRUCT Fournit les informations nécessaires à la fenêtre propriétaire pour déterminer comment peindre un contrôle ou un élément de menu dessiné par le propriétaire. La fenêtre propriétaire du contrôle ou de l’élément de menu dessiné par le propriétaire reçoit un pointeur vers cette structure en tant que paramètre lParam du message WM_DRAWITEM .
MEASUREITEMSTRUCT Informe le système des dimensions d’un contrôle ou d’un élément de menu dessiné par le propriétaire. Cela permet au système de traiter correctement l’interaction de l’utilisateur avec le contrôle.

Constantes

Rubrique Contenu
Styles de zone de liste modifiable Pour créer une zone de liste modifiable à l’aide de la fonction CreateWindow ou CreateWindowEx , spécifiez la classe COMBOBOX, les constantes de style de fenêtre appropriées et une combinaison des styles de zone de liste modifiable suivants.