Méthode ComboBox.AddItem (Access)
Ajoute un nouvel élément à la liste de valeurs affichées par le contrôle zone de liste déroulante spécifié.
Syntaxe
expression. AddItem (Item, Index)
Expression Variable qui représente un objet ComboBox .
Parameters
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| Item | Obligatoire | Chaîne | Texte affiché pour le nouvel élément. |
| Index | Facultatif | Variante | Position de l'élément dans la liste. Si cet argument est omis, l'élément est ajouté en fin de liste. |
Remarques
La propriété RowSourceType du contrôle spécifié doit être définie sur Liste de valeurs.
Cette méthode n'est valide que pour les contrôles zone de liste ou zone de liste déroulante des formulaires.
La numérotation des éléments de la liste commence à zéro. Si la valeur de l’argument Item ne correspond pas à un numéro d’élément existant, une erreur se produit.
Pour les listes comportant plusieurs colonnes, utilisez des points-virgules pour délimiter les chaînes de chaque colonne (par exemple, "1010;rouge;grand" pour une liste en trois colonnes). Si l’argument Item contient moins de chaînes que de colonnes dans le contrôle, les éléments sont ajoutés en commençant par la colonne la plus à gauche. Si l'argument Élément contient plus de chaînes que de colonnes dans le contrôle, les chaînes supplémentaires sont ignorées
Utilisez la méthode RemoveItem pour supprimer des éléments de la liste des valeurs.
Exemple
Cet exemple permet d’ajouter un élément à la fin de la liste d’un contrôle de zone de liste. Pour que la fonction puisse fonctionner, vous devez lui transmettre un objet ListBox représentant un contrôle de zone de liste sur un formulaire, ainsi qu’une valeur de type String représentant le texte de l’élément à ajouter.
Function AddItemToEnd(ctrlListBox As ListBox, _
ByVal strItem As String)
ctrlListBox.AddItem Item:=strItem
End Function
Cet exemple permet d’ ajouter un élément au début de la liste d’un contrôle de zone de liste déroulante. Pour que la fonction puisse fonctionner, vous devez lui transmettre un objet ComboBox représentant un contrôle de zone de liste déroulante sur un formulaire, ainsi qu’une valeur de type String représentant le texte de l’élément à ajouter.
Function AddItemToBeginning(ctrlComboBox As ComboBox, _
ByVal strItem As String)
ctrlComboBox.AddItem Item:=strItem, Index:=0
End Function
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.