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.