UserForm-Objekt

Ein UserForm-Objekt ist ein Fenster oder Dialogfeld, das Teil der Benutzeroberfläche einer Anwendung ist.

Die UserForms-Auflistung ist eine Auflistung, deren Elemente jedes geladene UserForm in einer Anwendung darstellen. Die UserForms-Auflistung verfügt über eine Count-Eigenschaft , eine Item-Methode und eine Add-Methode . Count gibt die Anzahl der Elemente in der Auflistung an. Item (das Standardelement) gibt ein bestimmtes Sammlungselement an. Hinzufügen platziert ein neues UserForm-Element in der Auflistung.

Syntax

UserFormUserForms [ . Element ] (Index)

Der Platzhalter index steht für eine ganze Zahl mit einem Bereich von 0 bis UserForms.Count - 1. Item ist das Standardelement der UserForms-Auflistung und muss nicht angegeben werden.

HinwBemerkungeneise

Verwenden Sie die UserForms-Auflistung , um alle geladenen Benutzerformulare in einer Anwendung zu durchlaufen. Sie identifiziert eine systeminterne globale Variable mit dem Namen UserForms. Sie können UserForms(Index) an eine Funktion übergeben, deren Argument als UserForm-Klasse angegeben wurde.

Benutzerformulare besitzen Eigenschaften, die die Darstellung, z. B. Position, Größe und Farbe; sowie Aspekte ihres Verhaltens bestimmen.

Benutzerformulare können auch auf die von einem Benutzer initiierten oder durch das System ausgelösten Ereignisse reagieren. Sie können zum Beispiel Code in der Initialize-Ereignisprozedur von UserForm schreiben, um Variablen auf Modulebene zu initialisieren, bevor das UserForm angezeigt wird.

Zusätzlich zu Eigenschaften und Ereignissen können Sie Methoden verwenden, um Benutzerformulare mithilfe von Code zu bearbeiten. Sie können z. B. die Move-Methode zum Ändern der Position und Größe eines UserForm verwenden.

Legen Sie beim Entwerfen von Benutzerformularen die BorderStyle-Eigenschaft so fest, dass Rahmen definiert werden, und legen Sie die Caption-Eigenschaft so fest, dass Text in der Titelleiste platziert wird. Im Code können Sie die Hide- und die Show-Methode verwenden, um ein UserForm zur Laufzeit sichtbar oder unsichtbar zu machen.

UserForm ist ein Objekt-Datentyp. Sie können Variablen als Typ UserForm deklarieren, bevor Sie sie auf eine Instanz vom Typ UserForm festlegen, der zur Entwurfszeit deklariert werden. Ebenso können Sie ein Argument an eine Prozedur als Typ UserForm übergeben. Sie können mehrere Instanzen von Benutzerformularen im Code mithilfe des New-Schlüsselworts in Dim-, Set- und Static-Anweisungen erstellen.

Greifen Sie mithilfe der Controls-Auflistung auf die Auflistung von Steuerelementen in einem UserForm-Formular zu. Um beispielsweise alle Steuerelemente in einem UserForm auszublenden, verwenden Sie Code wie den Folgenden.

For Each Control in UserForm1.Controls
    Control.Visible = False
Next Control

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.