Add-Methode (Microsoft Forms)

  • Artikel

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:

Teil 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.

Settings

ProgID-Werte für einzelne Steuerelemente lauten:

Kontrolle ProgID-Wert
Checkbox Forms.CheckBox.1
ComboBox Forms.ComboBox.1
CommandButton Forms.CommandButton.1
Frame 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

HinwBemerkungeneise

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 Designer-Eigenschaft 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.