Application.CreateControl-Methode (Access)

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 dem Formular die entsprechenden Steuerelemente hinzuzufügen.

Syntax

Ausdruck. 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 soll.
Parent	Optional	Variant	Der Name des übergeordneten Steuerelements eines angefügten Steuerelements. Verwenden Sie für Steuerelemente ohne übergeordnetes Steuerelement eine Zeichenfolge der Länge Null für dieses Argument, oder lassen Sie sie aus.
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

HinwBemerkungeneise

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

Sie verwenden das Übergeordnete Argument, um die Beziehung zwischen einem Hauptsteuerelement und einem untergeordneten Steuerelement zu identifizieren. Hat z. B. ein Textfeld ein zugeordnetes Bezeichnungsfeld, so ist das Textfeld das (übergeordnete) Hauptsteuerelement, und das Bezeichnungsfeld ist das untergeordnete Steuerelement. Legen Sie beim Erstellen des Bezeichnungssteuerelements das Übergeordnete Argument auf eine Zeichenfolge fest, die den Namen des übergeordneten Steuerelements identifiziert. Wenn Sie das Textfeld erstellen, legen Sie das Übergeordnete Argument auf eine Zeichenfolge der Länge Null fest.

Sie legen auch das Übergeordnete Argument 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 ob es an ein Feld in einer Tabelle gebunden wird oder nicht. 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.

Um ein Steuerelement aus einem Formular oder Bericht zu entfernen, verwenden Sie die Methoden DeleteControl und DeleteReportControl .

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.