Partager via


Objet ListBox (Outlook Forms Script)

Affiche une liste de valeurs et vous permet d'en sélectionner une ou plusieurs.

Remarques

Si listBox est lié à une source de données, le ListBox stocke la valeur sélectionnée dans cette source de données.

ListBox peut apparaître sous la forme d’une liste ou d’un groupe de contrôles OptionButton ou CheckBox.

La propriété par défaut d’un contrôle ListBox est la propriété Value .

L’événement par défaut d’un ListBox est l’événement Click .

Vous ne pouvez pas faire glisser du texte dans une ListBox déroulante.

Styles de zone de liste

Vous pouvez choisir entre deux styles de présentation pour un ListBox. Cela est exprimé par la propriété ListStyle . Chaque style offre aux utilisateurs une manière différente de sélectionner les éléments de la liste.

Si vous optez pour le style 0, chaque élément se trouve sur une ligne distincte ; l'utilisateur effectue une sélection en mettant une ou plusieurs lignes en surbrillance.

Si vous choisissez le style 1, un objet OptionButton ou CheckBox apparaît au début de chaque ligne. Avec ce style, l’utilisateur sélectionne un élément en cliquant sur la case d’option ou la case à cocher. Les cases à cocher s’affichent uniquement lorsque la propriété MultiSelect a la valeur True.

Événements

Nom Description
Click Survient lorsque l'utilisateur sélectionne précisément une valeur pour le contrôle offrant plusieurs valeurs possibles.

Méthodes

Nom Description
AddItem Pour un objet ListBox à une seule colonne, la méthode AddItem ajoute un élément à la liste. Dans le cas d’un objet ListBox à plusieurs colonnes, cette méthode ajoute une ligne à la liste.
Clear Supprime toutes les entrées de la liste d’un objet ListBox.
RemoveItem Supprime une ligne de la liste dans un contrôle ListBox.

Propriétés

Nom Description
BackColor Renvoie ou définit une valeur de type Long qui spécifie la couleur d’arrière-plan de l’objet. Lecture-écriture.
BorderColor Renvoie ou définit une valeur de type Long qui spécifie la couleur de bordure d’un objet. Lecture-écriture.
BorderStyle Renvoie ou définit une valeur de type Integer qui spécifie le type de bordure du contrôle. En lecture/écriture
BoundColumn Renvoie ou définit une valeur de type Variant qui identifie la source de données dans un ListBox multicolonne. En lecture/écriture
Colonne Renvoie ou définit un variant qui représente une valeur unique, une colonne de valeurs ou un tableau à deux dimensions à charger dans un ListBox. Lecture-écriture.
ColumnCount Renvoie ou définit une valeur de type Long qui représente le nombre de colonnes à afficher dans une zone de liste. En lecture/écriture
ColumnHeads Renvoie ou définit une valeur de type Boolean qui spécifie si une ligne d'en-têtes de colonne est affichée. En lecture/écriture
ColumnWidths Renvoie ou définit une valeur de type String qui spécifie la largeur de chaque colonne d’un listBox multicolonne. Lecture-écriture.
Enabled Renvoie ou définit une valeur booléenne qui spécifie si un contrôle peut recevoir le focus et répondre aux événements générés par l’utilisateur. Lecture-écriture.
ForeColor Renvoie ou définit une valeur de type Long qui spécifie la couleur d'avant-plan d'un objet. Lecture-écriture.
IMEMode Renvoie ou définit une valeur de type Integer qui spécifie le mode d'exécution par défaut de l'Éditeur de méthode d'entrée (IME) d'un contrôle. Lecture-écriture.
IntegralHeight Renvoie ou définit une valeur booléenne qui spécifie si un contrôle ListBox affiche des lignes complètes de texte dans une liste ou des lignes partielles. En lecture/écriture
List Renvoie ou définit une valeur de type Variant qui représente l’entrée spécifiée dans un contrôle ListBox. En lecture/écriture
ListCount Renvoie une valeur de type Long qui représente le nombre d'entrées de liste dans un contrôle. En lecture seule.
ListIndex Renvoie ou définit un variant qui représente l’élément actuellement sélectionné dans un contrôle ListBox. Lecture-écriture.
ListStyle Renvoie ou définit une valeur de type Integer qui spécifie l’apparence visuelle de la liste dans un contrôle ListBox. En lecture/écriture
Locked Renvoie ou définit une valeur de type Boolean qui spécifie si un contrôle peut être modifié. Lecture-écriture.
MatchEntry Renvoie ou définit une valeur de type Integer qui indique la façon dont un Contrôle ListBox recherche sa liste au fur et à mesure que l’utilisateur tape. En lecture/écriture
MouseIcon Renvoie une valeur de type String qui représente le nom complet du chemin d’accès d’une icône personnalisée qui doit être affectée au contrôle. En lecture seule.
MousePointer Renvoie ou définit une valeur de type Integer qui spécifie le type de pointeur affiché lorsque l’utilisateur positionne la souris sur un objet particulier. Lecture-écriture.
MultiSelect Renvoie ou définit une valeur de type Integer qui indique si l'objet autorise les sélections multiples. Lecture-écriture.
Selected Renvoie ou définit une valeur booléenne qui indique l’état de sélection des éléments d’un contrôle ListBox. Lecture-écriture.
SpecialEffect Renvoie ou définit une valeur de type Integer qui spécifie l’apparence visuelle d’un objet. Lecture-écriture.
Texte Renvoie ou définit une valeur de type String qui spécifie du texte dans un contrôle ListBox, en modifiant la ligne sélectionnée dans le contrôle. Lecture-écriture.
TextAlign Renvoie ou définit une valeur de type Integer qui spécifie le mode d'alignement du texte dans un contrôle. Lecture-écriture.
TextColumn Renvoie ou définit une valeur de type Variant qui identifie la colonne dans un contrôle ListBox à afficher à l’utilisateur. Lecture-écriture.
TopIndex Renvoie ou définit une valeur de type Long qui représente l'index de l'élément le plus haut dans la liste. Lecture-écriture.
Valeur Renvoie ou définit un Variant qui spécifie la valeur dans le BoundColumn des lignes actuellement sélectionnées. En lecture/écriture

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.