Add, méthode (Microsoft Forms)
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.