Add-Methode (Microsoft Forms)
Fügt ein Tab - oder Page-Objekt in einem TabStrip - oder MultiPage-Objekt hinzu oder fügt ein Steuerelement anhand des programmgesteuerten Bezeichners (ProgID) zu einer Seite oder einem Formular hinzu.
Syntax
Für MultiPage, TabStrip:
=
Objektobjekt festlegen.
Add( [ Name [, Caption [, index ]]] )
Für andere Steuerelemente:
Legen SiedasControl-Objekt = fest.
Add(ProgID [, Name [, Visible ]] )
Die Syntax der Add-Methode besteht aus folgenden Komponenten:
| Bestandteil | Beschreibung |
|---|---|
| Objekt | Erforderlich. Ein gültiger Objektname. |
| Name | Optional. Gibt den Namen des hinzugefügten Objekts an. Wenn kein Name angegeben wird, generiert das System einen Standardnamen basierend auf den Regeln der Anwendung, in der das Formular verwendet wird. |
| Caption | Optional. Gibt die Beschriftung an, die auf einer Registerkarte oder einem Steuerelement angezeigt wird. Wenn keine Beschriftung angegeben wird, erzeugt das System eine Standardbeschriftung basierend auf den Regeln der Anwendung, in der das Formular verwendet wird. |
| Index | Optional. Identifiziert die Position einer Seite oder Registerkarte innerhalb einer Pages- oder Tabs-Auflistung. Wenn kein Index angegeben wird, fügt das System die Seite oder Registerkarte am Ende der Pages- oder Tabs-Auflistung an und weist den entsprechenden Indexwert zu. |
| ProgID | Erforderlich. Programmkennung. Eine Textzeichenfolge ohne Leerstellen, mit der eine Objektklasse identifiziert wird. Die Standardsyntax für eine ProgID ist <Vendor>.<Komponente>.<Version>. Eine ProgID ist einem Klassenbezeichner (CLSID) zugeordnet. |
| Visible | Optional. True, wenn das Objekt sichtbar ist (Standardeinstellung). False, wenn das Objekt ausgeblendet ist. |
Einstellungen
ProgID-Werte für einzelne Steuerelemente lauten:
| Control | ProgID-Wert |
|---|---|
| CheckBox | Forms. CheckBox.1 |
| ComboBox | Forms. ComboBox.1 |
| CommandButton | Forms. CommandButton.1 |
| Rahmen | Forms. Frame.1 |
| Bild | Forms. Image.1 |
| Label | 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 |
Hinweise
Für ein MultiPage-Steuerelement gibt die Add-Methode ein Page-Objekt zurück. Für ein TabStrip-Steuerelement gibt sie ein Tab-Objekt zurück. Der Indexwert für das erste Page- oder Tab-Objekt einer Auflistung ist 0, der Wert für das zweite Page- oder Tab-Objekt ist 1 usw.
Für die Controls-Auflistung eines Objekts gibt die Add-Methode ein Steuerelement gemäß der angegebenen ProgID zurück. Das AddControl-Ereignis tritt ein, nachdem das Steuerelement hinzugefügt wurde.
Sie können der Controls-Auflistung eines Benutzerformulars zur Entwurfszeit ein Steuerelement hinzufügen, aber Sie müssen dazu die eigenschaft Designer der Microsoft Visual Basic for Applications Extensibility Library verwenden. Die Designer-Eigenschaft gibt das UserForm-Objekt zurück.
Mit der folgenden Syntax wird die Text-Eigenschaft des angegebenen Steuerelements zurückgegeben:
userform1.thebox.text
Wenn Sie zur Laufzeit ein Steuerelement hinzufügen, müssen Sie die Syntax mit Ausrufezeichen verwenden, um auf Eigenschaften des Steuerelements zu verweisen. Verwenden Sie z. B. die folgende Syntax, um die Text-Eigenschaft eines Steuerelements zurückzugeben, das zur Laufzeit hinzugefügt wurde:
userform1!thebox.text
Hinweis
Sie können die Name-Eigenschaft eines Steuerelements zur Laufzeit nur ändern, wenn Sie das Steuerelement zur Laufzeit mit der Add-Methode hinzugefügt haben.
Siehe auch
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.