Méthode ListBox.AddItem (Access)

  • Article

Ajoute un nouvel élément à la liste de valeurs affichées par le contrôle de zone de liste spécifié.

Syntaxe

expression. AddItem (Item, Index)

Expression Variable qui représente un objet ListBox .

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.