DoCmd.OpenForm-Methode (Access)
Mit der OpenForm-Methode wird die OpenForm-Aktion in Visual Basic ausgeführt.
Syntax
expression.OpenForm (FormName, View, FilterName, WhereCondition, DataMode, WindowMode, OpenArgs)
expression Eine Variable, die ein DoCmd-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| FormName | Erforderlich | Variant | Ein Zeichenfolgenausdruck, der dem gültigen Namen eines Formulars in der aktuellen Datenbank entspricht. Wenn Sie Visual Basis-Code, der die OpenForm-Methode enthält, in einer Bibliotheksdatenbank ausführen, wird in Microsoft Access das Formular mit diesem Namen zuerst in der Bibliotheksdatenbank und dann in der aktuellen Datenbank gesucht. |
| View | Optional | AcFormView | Eine AcFormView-Konstante, welche die Ansicht angibt, in der das Formular geöffnet wird. Der Standardwert lautet acNormal. |
| FilterName | Optional | Variant | Ein Zeichenfolgenausdruck, der dem gültigen Namen einer Abfrage in der aktuellen Datenbank entspricht. |
| WhereCondition | Optional | Variant | Ein Zeichenfolgenausdruck, der einer gültigen SQL-WHERE-Klausel ohne das Wort WHERE entspricht. |
| DataMode | Optional | AcFormOpenDataMode | Eine AcFormOpenDataMode-Konstante, die den Dateneingabemodus für das Formular angibt. Dies gilt nur für Formulare, die in der Formularansicht oder in der Datenblattansicht geöffnet werden. Der Standardwert ist acFormPropertySettings. |
| WindowMode | Optional | AcWindowMode | Eine AcWindowMode-Konstante, die den Fenstermodus angibt, in der das Formular geöffnet wird. Der Standardwert ist acWindowNormal. |
| OpenArgs | Optional | Variant | Ein Zeichenfolgenausdruck. Dieser Ausdruck wird verwendet, um die OpenArgs-Eigenschaft des Formulars festzulegen. Diese Einstellung kann vom Code in einem Formularmodul verwendet werden, z. B. die Open-Ereignisprozedur. Auf die OpenArgs-Eigenschaft kann auch in Makros und Ausdrücken verwiesen werden. Angenommen, das Formular, das Sie öffnen, ist eine Liste von Clients in einem Endlosformular. Wenn der Fokus auf einen bestimmten Datensatz verschoben werden soll, wenn das Formular geöffnet wird, können Sie den Clientnamen mit dem OpenArgs-Argument angeben und dann die FindRecord-Methode verwenden, um den Fokus auf den Datensatz für den Client mit dem angegebenen Namen zu verschieben. |
Hinweise
Verwenden Sie die OpenForm -Methode, um ein Formular in der Formularansicht, in der Formular-Entwurfsansicht, in der Seitenansicht oder in der Datenblattansicht zu öffnen. Sie können den Dateneingabe- und den Fenstermodus für das Formular auswählen und die Datensätze einschränken, die das Formular anzeigt.
Die maximale Länge des WhereCondition-Arguments beträgt 32.768 Zeichen (im Gegensatz zum WhereCondition-Aktionsargument im Makrofenster, dessen Länge auf maximal 256 Zeichen beschränkt ist).
Beispiel
Dieses Beispiel öffnet das Formular Personal in der Formularansicht und zeigt nur die Datensätze an, in denen im Feld LastName der Name "Buchwald" steht. Die angezeigten Datensätze können bearbeitet werden, und neue Datensätze können hinzugefügt werden.
DoCmd.OpenForm "Employees", , ,"LastName = 'King'"
Im folgenden Beispiel wird das Formular frmMainEmployees in der Formularansicht geöffnet, und es werden nur Datensätze angezeigt, die für die Abteilung zutreffen, die durch das Kombinationsfeld cboDept ausgewählt wurde. Die angezeigten Datensätze können bearbeitet werden, und neue Datensätze können hinzugefügt werden.
Private Sub cmdFilter_Click()
DoCmd.OpenForm "frmMainEmployees", , , "DepartmentID=" & cboDept.Value
End Sub
Das folgende Beispiel zeigt, wie Sie das Argument WhereCondition der Methode OpenForm verwenden, um die in einem Formular angezeigten Datensätze zu filtern, während es geöffnet wird.
Private Sub cmdShowOrders_Click()
If Not Me.NewRecord Then
DoCmd.OpenForm "frmOrder", _
WhereCondition:="CustomerID=" & Me.txtCustomerID
End If
End Sub
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.