ÉLÉMENT LISTBOX

  • Article

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

L’élément LISTBOX permet aux utilisateurs de sélectionner des éléments dans une liste. Ces éléments peuvent être spécifiés en utilisant des éléments ITEM en tant qu’enfants de l’élément LISTBOX . Si vous avez besoin d’un contrôle de zone de liste qui s’affiche uniquement en cas de besoin, utilisez l’élément POPUP , qui est identique à l’élément LISTBOX , à l’exception de la valeur par défaut de l’attribut popUp , qui dicte son comportement d’affichage.

L’élément LISTBOX prend en charge les attributs suivants.

Attribut Description
Backgroundcolor Spécifie ou récupère la couleur d’arrière-plan dans le contrôle de zone de liste.
Frontière Spécifie ou récupère une valeur indiquant si le contrôle de zone de liste a une bordure. Ne peut être défini qu’au moment de la conception.
firstVisibleItem Spécifie ou récupère l’index de la première ligne visible dans le contrôle de zone de liste.
focusItem Spécifie ou récupère la ligne qui contient le focus.
fontFace Spécifie ou récupère la police pour le contrôle de zone de liste.
Fontsize Spécifie ou récupère la taille de police pour le contrôle de zone de liste.
Fontstyle Spécifie ou récupère le style de police pour le contrôle de zone de liste.
Foregroundcolor Spécifie ou récupère la couleur du texte dans le contrôle de zone de liste.
itemCount Récupère le nombre d’éléments dans le contrôle de zone de liste.
Multiselect Spécifie ou récupère une valeur indiquant si l’utilisateur peut sélectionner plusieurs lignes. Ne peut être défini qu’au moment de la conception.
Popup Spécifie une valeur indiquant si l’élément représente un contrôle de fenêtre contextuelle ou de zone de liste.
readOnly Spécifie ou récupère une valeur indiquant si le texte est en lecture seule ou si le texte peut être sélectionné par l’utilisateur.
Selecteditem Spécifie ou récupère l’index de l’élément sélectionné dans le contrôle de zone de liste.
Triés Spécifie ou récupère une valeur indiquant si le contrôle de zone de liste est trié par ordre alphabétique.

 

L’élément LISTBOX prend en charge les méthodes suivantes.

Méthode Description
appendItem Insère un nouveau texte à la fin du contrôle de zone de liste.
deleteAll Supprime tous les éléments du contrôle de zone de liste.
deleteItem Supprime l’élément de contrôle de zone de liste à l’index spécifié.
Rejeter Masque le contrôle.
findItem Recherche une chaîne donnée en commençant par l’élément suivant l’index d’élément spécifié.
getItem Récupère le texte de l’élément avec l’index spécifié.
getNextSelectedItem Récupère l’élément sélectionné suivant dans le contrôle de zone de liste en commençant à l’élément après celui avec l’index spécifié.
insertItem Insère le texte spécifié à l’index spécifié dans le contrôle de zone de liste.
replaceItem Remplace le texte à l’index spécifié par le texte spécifié.
setSelectedState Sélectionne ou désélectionne l’élément avec l’index spécifié.
show Affiche le contrôle.

 

Notes

Cet élément nécessite Lecteur multimédia Windows pour Windows XP ou version ultérieure.

 

ÉLÉMENT POPUP

Informations de référence sur la programmation d’apparence