Zone de liste

Cette section contient des informations sur les éléments de programmation utilisés avec les zones de liste. Une zone de liste est une fenêtre de contrôle qui contient une liste simple d’éléments à partir desquelles l’utilisateur peut choisir. Pour les listes plus complexes, utilisez plutôt l’affichage Liste .

Vues d'ensemble

Rubrique	Contenu
À propos des zones de liste	Décrit les fonctionnalités de zone de liste.
Utilisation de zones de liste	Explique comment effectuer des tâches associées aux zones de liste.

Fonctions

Rubrique	Contenu
DlgDirList	Remplace le contenu d’une zone de liste par les noms des sous-répertoires et fichiers d’un répertoire spécifié.
DlgDirSelectEx	Récupère la sélection actuelle à partir d’une zone de liste à sélection unique.
DrawInsert	Dessine l’icône d’insertion dans la fenêtre parente de la zone de liste de glissement spécifiée.
GetListBoxInfo	Récupère des informations sur la zone de liste spécifiée.
LBItemFromPt	Récupère l’index de l’élément au point spécifié dans une zone de liste.
MakeDragList	Remplace la zone de liste à sélection unique spécifiée par une zone de liste de glisser.

Messages

Rubrique	Contenu
LB_ADDFILE	Ajoute le nom de fichier spécifié à une zone de liste qui contient une liste de répertoires.
LB_ADDSTRING	Ajoute une chaîne à une zone de liste.
LB_DELETESTRING	Supprime une chaîne dans une zone de liste.
LB_DIR	Ajoute des noms à la liste affichée par une zone de liste.
LB_FINDSTRING	Recherche la première chaîne dans une zone de liste qui commence par la chaîne spécifiée.
LB_FINDSTRINGEXACT	Recherche la première chaîne de zone de liste qui correspond exactement à la chaîne spécifiée, sauf que la recherche ne respecte pas la casse.
LB_GETANCHORINDEX	Obtient l’index de l’élément d’ancre, c’est-à-dire l’élément à partir duquel une sélection multiple démarre.
LB_GETCARETINDEX	Récupère l’index de l’élément qui a le rectangle de focus dans une zone de liste à sélection multiple. L’élément peut être sélectionné ou non.
LB_GETCOUNT	Obtient le nombre d’éléments dans une zone de liste.
LB_GETCURSEL	Obtient l’index de l’élément actuellement sélectionné, le cas échéant, dans une zone de liste à sélection unique.
LB_GETHORIZONTALEXTENT	Obtient la largeur, en pixels, qu’une zone de liste peut être défiler horizontalement (largeur de défilement) si la zone de liste a une barre de défilement horizontale.
LB_GETITEMDATA	Obtient la valeur définie par l’application associée à l’élément de zone de liste spécifié.
LB_GETITEMHEIGHT	Obtient la hauteur des éléments dans une zone de liste.
LB_GETITEMRECT	Obtient les dimensions du rectangle qui limite un élément de zone de liste tel qu’il est actuellement affiché dans la zone de liste.
LB_GETLISTBOXINFO	Obtient le nombre d’éléments par colonne dans une zone de liste spécifiée.
LB_GETLOCALE	Obtient les paramètres régionaux actuels de la zone de liste.
LB_GETSEL	Obtient l’état de sélection d’un élément.
LB_GETSELCOUNT	Obtient le nombre total d’éléments sélectionnés dans une zone de liste à sélection multiple.
LB_GETSELITEMS	Remplit une mémoire tampon avec un tableau d’entiers qui spécifient les numéros d’éléments des éléments sélectionnés dans une zone de liste à sélection multiple.
LB_GETTEXT	Obtient une chaîne à partir d’une zone de liste.
LB_GETTEXTLEN	Obtient la longueur d’une chaîne dans une zone de liste.
LB_GETTOPINDEX	Obtient l’index du premier élément visible dans une zone de liste.
LB_INITSTORAGE	Alloue de la mémoire pour le stockage des éléments de zone de liste. Ce message est utilisé avant qu’une application n’ajoute un grand nombre d’éléments à une zone de liste.
LB_INSERTSTRING	Insère une chaîne ou des données d’élément dans une zone de liste. Contrairement au message LB_ADDSTRING , le message LB_INSERTSTRING n’entraîne pas le tri d’une liste avec le style LBS_SORT .
LB_ITEMFROMPOINT	Obtient l’index de base zéro de l’élément le plus proche du point spécifié dans une zone de liste.
LB_RESETCONTENT	Supprime tous les éléments d’une zone de liste.
LB_SELECTSTRING	Recherche dans une zone de liste un élément qui commence par les caractères d’une chaîne spécifiée.
LB_SELITEMRANGE	Sélectionne ou désélectionne un ou plusieurs éléments consécutifs dans une zone de liste à sélection multiple.
LB_SELITEMRANGEEX	Sélectionne un ou plusieurs éléments consécutifs dans une zone de liste à sélection multiple.
LB_SETANCHORINDEX	Définit l’élément d’ancre, c’est-à-dire l’élément à partir duquel une sélection multiple démarre. Une sélection multiple couvre tous les éléments de l’élément d’ancrage à l’élément caret.
LB_SETCARETINDEX	Définit le rectangle de focus sur l’élément à l’index spécifié dans une zone de liste à sélection multiple. Si l’élément n’est pas visible, il est fait défiler dans l’affichage.
LB_SETCOLUMNWIDTH	Définit la largeur, en pixels, de toutes les colonnes d’une zone de liste à plusieurs colonnes.
LB_SETCOUNT	Définit le nombre d’éléments dans une zone de liste créée avec le style LBS_NODATA et non avec le style LBS_HASSTRINGS .
LB_SETCURSEL	Sélectionne une chaîne et la fait défiler dans l’affichage, si nécessaire.
LB_SETHORIZONTALEXTENT	Définit la largeur, en pixels, par laquelle une zone de liste peut être défiler horizontalement (largeur de défilement).
LB_SETITEMDATA	Définit une valeur associée à l’élément spécifié dans une zone de liste.
LB_SETITEMHEIGHT	Définit la hauteur, en pixels, des éléments d’une zone de liste.
LB_SETLOCALE	Définit les paramètres régionaux actuels de la zone de liste.
LB_SETSEL	Sélectionne une chaîne dans une zone de liste à sélection multiple.
LB_SETTABSTOPS	Définit les positions de tabulation dans une zone de liste.
LB_SETTOPINDEX	Garantit que l’élément spécifié dans une zone de liste est visible.

Notifications

Rubrique	Contenu
LBN_DBLCLK	Avertit l’application que l’utilisateur a double-cliqué sur un élément dans une zone de liste.
LBN_ERRSPACE	Avertit l’application que la zone de liste ne peut pas allouer suffisamment de mémoire pour répondre à une demande spécifique.
LBN_KILLFOCUS	Avertit l’application que la zone de liste a perdu le focus du clavier.
LBN_SELCANCEL	Avertit l’application que l’utilisateur a annulé la sélection dans une zone de liste.
LBN_SELCHANGE	Avertit l’application que la sélection dans une zone de liste a changé.
LBN_SETFOCUS	Avertit l’application que la zone de liste a reçu le focus clavier.
WM_CHARTOITEM	Envoyé par une zone de liste avec le style LBS_WANTKEYBOARDINPUT à son propriétaire en réponse à un message WM_CHAR .
WM_CTLCOLORLISTBOX	Envoyé à la fenêtre parente d’une zone de liste avant que le système ne dessine la zone de liste. En répondant à ce message, la fenêtre parente peut définir le texte et les couleurs d’arrière-plan de la zone de liste à l’aide du handle de contexte de périphérique d’affichage spécifié.
WM_DELETEITEM	Envoyé au propriétaire d’une zone de liste ou d’une zone de liste modifiable lorsque la zone de liste ou la zone de liste déroulante est détruite ou lorsque des éléments sont supprimés par le message LB_DELETESTRING, LB_RESETCONTENT, CB_DELETESTRING ou CB_RESETCONTENT .
WM_VKEYTOITEM	Envoyé par une zone de liste avec le style LBS_WANTKEYBOARDINPUT à son propriétaire en réponse à un message WM_KEYDOWN .
DL_BEGINDRAG	Avertit la fenêtre parente de la zone de liste glisser que l’utilisateur a cliqué sur le bouton gauche de la souris sur un élément.
DL_CANCELDRAG	Indique que l’utilisateur a annulé une opération de glissement en cliquant sur le bouton droit de la souris ou en appuyant sur la touche Échap.
DL_DRAGGING	Signale que l’utilisateur a déplacé la souris lors du déplacement d’un élément.
DL_DROPPED	Indique que l’utilisateur a terminé une opération de glissement en relâchant le bouton gauche de la souris.

Structures

Rubrique	Contenu
DELETEITEMSTRUCT	Contient des informations sur un élément de zone de liste ou de zone de liste modifiable supprimé.
DRAGLISTINFO	Contient des informations sur un événement de glissement. Le pointeur vers DRAGLISTINFO est passé en tant que paramètre lParam du message de liste de glisser.

Constantes

Rubrique	Contenu
Styles de zone de liste	Décrit les styles de fenêtre qui définissent un contrôle de zone de liste.