objet ListBox (script Outlook Forms)

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

Remarques

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

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

La propriété par défaut d’une ListBox est la propriété Value .

L’événement par défaut d’une 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. Ceci 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 apparaissent uniquement lorsque la propriété MultiSelect a la valeur Vrai.

É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 une zone de liste.

Propriétés

Nom Description
BackColor Renvoie ou définit une longue qui spécifie la couleur d’arrière-plan de l’objet. Lecture-écriture.
BorderColor Renvoie ou définit un Long qui spécifie la couleur de bordure d’un objet. Lecture-écriture.
BorderStyle Renvoie ou définit un nombre entier qui spécifie le type de bordure du contrôle. Lecture-écriture.
BoundColumn Renvoie ou définit une variante qui identifie la source des données dans une zone de liste à plusieurs colonnes. Lecture-écriture.
Colonne Renvoie ou définit une variante qui représente une valeur unique, une colonne de valeurs ou un tableau à deux dimensions à charger dans une 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. 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. Lecture-écriture.
ColumnWidths Renvoie ou définit une chaîne qui spécifie la largeur de chaque colonne dans une zone de liste à plusieurs colonnes. Lecture-écriture.
Enabled Renvoie ou définit une valeur booléenne spécifiant 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 une zone de liste affiche des lignes de texte complètes dans une liste ou des lignes partielles. Lecture-écriture.
List Renvoie ou définit une variante qui représente l’entrée spécifiée dans une zone de liste. 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 une variante qui représente l’élément actuellement sélectionné dans une zone de liste. Lecture-écriture.
ListStyle Renvoie ou définit un nombre entier qui spécifie l’apparence visuelle de la liste dans une zone de liste. 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 un nombre entier qui indique comment une zone de liste recherche dans sa liste à mesure que l’utilisateur tape. Lecture-écriture.
MouseIcon Renvoie une chaîne qui représente le nom de chemin d’accès complet d’une icône personnalisée qui doit être affectée au contrôle. En lecture seule.
MousePointer Renvoie ou définit un nombre entier 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 indiquant l’état de sélection des éléments d’une zone de liste. Lecture-écriture.
SpecialEffect Renvoie ou définit un nombre entier qui spécifie l’apparence visuelle d’un objet. Lecture-écriture.
Text Renvoie ou définit une chaîne qui spécifie du texte dans une zone de liste, 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 variante qui identifie la colonne dans une zone de liste à 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 une variante qui spécifie la valeur dans la BoundColumn des lignes actuellement sélectionnées. 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.

  • Last updated on