Add, méthode (Microsoft Forms)

  • Article

Ajoute ou insère un onglet ou une page dans un Contrôle TabStrip ou MultiPage, ou ajoute un contrôle par son identificateur programmatique (ProgID) à une page ou un formulaire.

Syntaxe

Pour MultiPage, TabStrip :
Définirl’objet Object = . Add( [ Name [, Caption [, index ]]] )

Pour les autres contrôles :
Définirl’objet Control = . Add(ProgID [, Name [, Visible ]] )

La syntaxe de la méthode Add comporte les parties suivantes :

Élément Description
object Obligatoire. Nom d’objet valide.
Name Facultatif. Spécifie le nom de l’objet ajouté. Si aucun nom n’est spécifié, le système génère un nom par défaut en fonction des règles de l’application où est utilisé le formulaire.
Caption Facultatif. Spécifie la légende à afficher sur un onglet ou un contrôle. Si aucune légende n'est spécifiée, le système génère une légende par défaut en fonction des règles de l'application dans laquelle le formulaire est utilisé.
index Facultatif. Identifie la position d’ une page ou d’un onglet dans une collection de Pages ou de Tabs. Si aucun index n’est spécifié, le système ajoute la page ou l’onglet à la fin de la collection de Pages ou Tabs et lui attribue la valeur d’index appropriée.
ProgID Obligatoire. Identificateur programmatique. Chaîne de texte sans espace qui identifie une classe d’objets. La syntaxe standard d’un ProgID est <Vendor>.< Composant>.< Version>. Un identificateur IDProg est mappé à un identificateur de classe (CLSID).
Visible Facultatif. True si l’objet est visible (par défaut). False si l’objet est masqué.

Settings

Valeurs d’IDProg selon les contrôles :

Contrôle Valeur progID
Case Forms.CheckBox.1
ComboBox Forms.ComboBox.1
CommandButton Forms.CommandButton.1
Frame Forms.Frame.1
Image Forms.Image.1
Étiquette Forms.Label.1
Listbox Forms.ListBox.1
Multipage Forms.MultiPage.1
OptionButton Forms.OptionButton.1
Scrollbar Forms.ScrollBar.1
SpinButton Forms.SpinButton.1
Tabstrip Forms.TabStrip.1
TextBox Forms.TextBox.1
Togglebutton Forms.ToggleButton.1

Remarques

Pour un contrôle MultiPage, la méthode Add renvoie un objet Page. Pour un TabStrip, elle renvoie un objet Tab. La valeur d’index de la première Page ou Tab d’une collection est 0, la valeur de la deuxième Page ou Tab est 1, et ainsi de suite.

Pour la collection Controls d’un objet, la méthode Add renvoie un contrôle correspondant à l’IDProg spécifié. L’événement AddControl se produit après l’ajout du contrôle.

Vous pouvez ajouter un contrôle à la collection Controls d’un formulaire utilisateur au moment du design, mais vous devez utiliser la propriété Designer de la bibliothèque d’extensibilité Microsoft Visual Basic pour Applications pour ce faire. La propriété Designer renvoie l’objet UserForm .

La syntaxe suivante va renvoyer la propriété Text du contrôle spécifié :

userform1.thebox.text

Si vous ajoutez un contrôle à l’exécution, vous devez utiliser la syntaxe d’exclamation pour faire référence aux propriétés de ce contrôle. Par exemple, pour renvoyer la propriété Text d’un contrôle ajouté à l’exécution, respectez la syntaxe suivante :

userform1!thebox.text

Remarque

Vous pouvez changer la propriété Name d’un contrôle à l’exécution uniquement si vous avez ajouté ce contrôle à l’exécution avec la méthode Add.

Voir aussi

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.