Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Mit der CreateControl-Methode wird ein Steuerelement für ein angegebenes geöffnetes Formular erstellt. Angenommen, Sie möchten einen benutzerdefinierten Assistenten erstellen, mit dessen Hilfe Benutzer problemlos ein bestimmtes Formular erstellen können. Verwenden Sie die CreateControl-Methode in Ihrem Assistenten, um die entsprechenden Steuerelemente zum Formular hinzuzufügen.
Syntax
Ausdruck verwendet werden. CreateControl (FormName, ControlType, Section, Parent, ColumnName, Left, Top, Width, Height)
expression Eine Variable, die ein Application-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| FormName | Erforderlich | String | Der Name des geöffneten Formulars oder Berichts, für das bzw. für den Sie das Steuerelement erstellen möchten. |
| ControlType | Erforderlich | AcControlType | Eine AcControlType-Konstante, die den Typ des Steuerelements darstellt, das Sie erstellen möchten. |
| Section | Optional | AcSection | Eine AcSection-Konstante, die den Abschnitt identifiziert, der das neue Steuerelement enthalten wird. |
| Parent | Optional | Variant | Der Name des übergeordneten Steuerelements eines angefügten Steuerelements. Verwenden Sie für Steuerelemente, die kein übergeordnetes Steuerelement haben, für dieses Argument eine Zeichenfolge der Länge Null, oder lassen Sie die Zeichenfolge weg. |
| ColumnName | Optional | Variant | Der Name des Felds, an das das Steuerelement gebunden wird, wenn es sich um ein datengebundenes Steuerelement handeln soll. |
| Left,Top | Optional | Variant | Die Koordinaten für die obere linke Ecke des Steuerelements in Twips. |
| Width, Height | Optional | Variant | Numerische Ausdrücke, die die Breite und Höhe des Steuerelements in Twips anzeigen. |
Rückgabewert
Control
Hinweise
Verwenden Sie die Methoden "CreateControl" und "CreateReportControl" in einem benutzerdefinierten Assistenten, um Steuerelemente in einem Formular oder Bericht zu erstellen. Beide Methoden geben ein Control -Objekt zurück.
Verwenden Sie die Methoden "CreateControl" und " CreateReportControl" nur in der Formularentwurfsansicht bzw. in der Berichtsentwurfsansicht.
Mit dem übergeordneten Argument können Sie die Beziehung zwischen einem Hauptsteuerelement und einem untergeordneten Steuerelement identifizieren. Hat z. B. ein Textfeld ein zugeordnetes Bezeichnungsfeld, so ist das Textfeld das (übergeordnete) Hauptsteuerelement, und das Bezeichnungsfeld ist das untergeordnete Steuerelement. Wenn Sie das Bezeichnungssteuerelement erstellen, legen Sie das übergeordnete Argument auf eine Zeichenfolge fest, die den Namen des übergeordneten Steuerelements angibt. Legen Sie beim Erstellen des Textfelds das übergeordnete Argument auf eine Zeichenfolge der Länge Null fest.
Das übergeordnete Argument legen Sie auch fest, wenn Sie Kontrollkästchen, Optionsfelder oder Umschaltflächen erstellen. Eine Optionsgruppe ist das übergeordnete Steuerelement der darin enthaltenen Kontrollkästchen, Optionsfelder oder Umschaltflächen. Die einzigen Steuerelemente, für die es ein übergeordnetes Steuerelement geben kann, sind Bezeichnungsfeld, Kontrollkästchen, Optionsfeld und Umschaltfläche. Alle diese Steuerelemente können auch unabhängig, also ohne ein übergeordnetes Steuerelement erstellt werden.
Legen Sie das Argument ColumnName entsprechend dem Typ des Steuerelements fest, das Sie erstellen, und geben Sie an, ob es an ein Feld in einer Tabelle gebunden wird. Die Steuerelemente, die an ein Feld gebunden werden können, umfassen Textfeld, Listenfeld, Kombinationsfeld, Optionsgruppe und gebundenes Objektfeld. Darüber hinaus können die Umschaltfläche-, Optionsfeld- und die Kontrollkästchen-Steuerelemente an ein Feld gebunden werden, wenn sie nicht in einer Optionsgruppe enthalten sind.
Wenn Sie den Namen eines Felds für das Argument ColumnName angeben, erstellen Sie ein Steuerelement, das an dieses Feld gebunden ist. Alle Eigenschaften des Steuerelements werden dann automatisch auf die Einstellungen der entsprechenden Feldeigenschaften festgelegt. Der Wert der ValidationRule-Eigenschaft des Steuerelements entspricht zum Beispiel dem Wert der Eigenschaft für das Feld.
Hinweis
Wenn der Assistent Steuerelemente in einem neuen oder vorhandenen Formular oder Bericht erstellt, müssen Sie zuerst das Formular bzw. den Bericht in der Entwurfsansicht öffnen.
Verwenden Sie die DeleteControl - und DeleteReportControl-Methoden , um ein Steuerelement aus einem Formular oder Bericht zu entfernen.
Beispiel
Im folgenden Beispiel wird zunächst ein neues Formular basierend auf der Tabelle „Bestellungen“ erstellt. Anschließend wird mithilfe der CreateControl-Methode im Formular ein Textfeld-Steuerelement und ein zugeordnetes Bezeichnungsfeld-Steuerelement erstellt.
Sub NewControls()
Dim frm As Form
Dim ctlLabel As Control, ctlText As Control
Dim intDataX As Integer, intDataY As Integer
Dim intLabelX As Integer, intLabelY As Integer
' Create new form with Orders table as its record source.
Set frm = CreateForm
frm.RecordSource = "Orders"
' Set positioning values for new controls.
intLabelX = 100
intLabelY = 100
intDataX = 1000
intDataY = 100
' Create unbound default-size text box in detail section.
Set ctlText = CreateControl(frm.Name, acTextBox, , "", "", _
intDataX, intDataY)
' Create child label control for text box.
Set ctlLabel = CreateControl(frm.Name, acLabel, , _
ctlText.Name, "NewLabel", intLabelX, intLabelY)
' Restore form.
DoCmd.Restore
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.