Application.CreateControl-Methode (Access)Application.CreateControl method (Access)

Mit der CreateControl-Methode wird ein Steuerelement für ein angegebenes geöffnetes Formular erstellt.The CreateControl method creates a control on a specified open form. Angenommen, Sie möchten einen benutzerdefinierten Assistenten erstellen, mit dessen Hilfe Benutzer problemlos ein bestimmtes Formular erstellen können.For example, suppose you are building a custom wizard that allows users to easily construct a particular form. In diesem Fall können Sie die CreateControl-Methode in dem Assistenten verwenden, um die entsprechenden Steuerelemente dem Formular hinzuzufügen.You can use the CreateControl method in your wizard to add the appropriate controls to the form.

SyntaxSyntax

Ausdruck. CreateControl (FormName, ControlType, section, Parent, ColumnName, left, Top, Width, height)expression.CreateControl (FormName, ControlType, Section, Parent, ColumnName, Left, Top, Width, Height)

expression Eine Variable, die ein Application-Objekt darstellt.expression A variable that represents an Application object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
FormNameFormName ErforderlichRequired StringString Der Name des geöffneten Formulars oder Berichts, für das bzw. für den Sie das Steuerelement erstellen möchten.The name of the open form or report on which you want to create the control.
ControlTypeControlType ErforderlichRequired AcControlTypeAcControlType Eine AcControlType -Konstante, die den Typ des zu erstellenden Steuerelements darstellt.An AcControlType constant that represents the type of control that you want to create.
SectionSection OptionalOptional AcSectionAcSection Eine AcSection -Konstante, die den Abschnitt identifiziert, der das neue Steuerelement enthält.An AcSection constant that identifies the section that will contain the new control.
ParentParent OptionalOptional VariantVariant Der Name des übergeordneten Steuerelements eines angefügten Steuerelements.The name of the parent control of an attached control. Verwenden Sie für Steuerelemente, die kein übergeordnetes Steuerelement haben, eine leere Zeichenfolge für dieses Argument, oder lassen Sie Sie aus.For controls that have no parent control, use a zero-length string for this argument or omit it.
ColumnNameColumnName OptionalOptional VariantVariant Der Name des Felds, an das das Steuerelement gebunden wird, wenn es sich um ein datengebundenes Steuerelement handelt.The name of the field to which the control will be bound if it is to be a data-bound control.
Left,TopLeft,Top OptionalOptional VariantVariant Die Koordinaten für die obere linke Ecke des Steuerelements in Twips.The coordinates for the upper-left corner of the control in twips.
Width, HeightWidth, Height OptionalOptional VariantVariant Numerische Ausdrücke, die die Breite und Höhe des Steuerelements in Twips anzeigen.Numeric expressions indicating the width and height of the control in twips.

RückgabewertReturn value

ControlControl

HinweiseRemarks

Sie können die Methoden CreateControl und **** CreateReportControl in einem benutzerdefinierten Assistenten verwenden, um Steuerelemente in einem Formular oder Bericht zu erstellen.You can use the CreateControl and CreateReportControl methods in a custom wizard to create controls on a form or report. Beide Methoden geben ein Control-Objekt zurück.Both methods return a Control object.

Sie können die CreateControl und CreateReportControl-Methoden nur in der Entwurfsansicht für Formulare bzw. der Entwurfsansicht für Berichte verwenden.You can use the CreateControl and CreateReportControl methods only in form Design view or report Design view, respectively.

Sie verwenden das Parent -Argument, um die Beziehung zwischen einem Hauptsteuerelement und einem untergeordneten Steuerelement zu identifizieren.You use the Parent argument to identify the relationship between a main control and a subordinate control. Hat z. B. ein Textfeld ein zugeordnetes Bezeichnungsfeld, so ist das Textfeld das (übergeordnete) Hauptsteuerelement, und das Bezeichnungsfeld ist das untergeordnete Steuerelement.For example, if a text box has an attached label, the text box is the main (or parent) control and the label is the subordinate (or child) control. Legen Sie beim Erstellen des Label-Steuerelements das übergeordnete Argument auf eine Zeichenfolge fest, die den Namen des übergeordneten Steuerelements identifiziert.When you create the label control, set its Parent argument to a string identifying the name of the parent control. Legen Sie beim Erstellen des Textfelds das übergeordnete Argument auf eine leere Zeichenfolge fest.When you create the text box, set its Parent argument to a zero-length string.

Sie können auch das übergeordnete Argument festlegen, wenn Sie Kontrollkästchen, Optionsfelder oder Umschaltflächen erstellen.You also set the Parent argument when you create check boxes, option buttons, or toggle buttons. Eine Optionsgruppe ist das übergeordnete Steuerelement der darin enthaltenen Kontrollkästchen, Optionsfelder oder Umschaltflächen.An option group is the parent control of any check boxes, option buttons, or toggle buttons that it contains. Die einzigen Steuerelemente, für die es ein übergeordnetes Steuerelement geben kann, sind Bezeichnungsfeld, Kontrollkästchen, Optionsfeld und Umschaltfläche.The only controls that can have a parent control are a label, check box, option button, or toggle button. Alle diese Steuerelemente können auch unabhängig, also ohne ein übergeordnetes Steuerelement erstellt werden.All of these controls can also be created independently, without a parent control.

Legen Sie das Argument ColumnName entsprechend dem Typ des zu erstellenden Steuerelements fest, und geben Sie an, ob es an ein Feld in einer Tabelle gebunden wird.Set the ColumnName argument according to the type of control that you are creating and whether or not it will be bound to a field in a table. Die Steuerelemente, die an ein Feld gebunden werden können, umfassen Textfeld, Listenfeld, Kombinationsfeld, Optionsgruppe und gebundenes Objektfeld.The controls that may be bound to a field include the text box, list box, combo box, option group, and bound object frame. 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.Additionally, the toggle button, option button, and check box controls may be bound to a field if they are not contained in an option group.

Wenn Sie den Namen eines Felds für das Argument ColumnName angeben, erstellen Sie ein Steuerelement, das an dieses Feld gebunden ist.If you specify the name of a field for the ColumnName argument, you create a control that is bound to that field. Alle Eigenschaften des Steuerelements werden dann automatisch auf die Einstellungen der entsprechenden Feldeigenschaften festgelegt.All of the control's properties are then automatically set to the settings of any corresponding field properties. Der Wert der ValidationRule-Eigenschaft des Steuerelements entspricht zum Beispiel dem Wert der Eigenschaft für das Feld.For example, the value of the control's ValidationRule property will be the same as the value of that property for the field.

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.If your wizard creates controls on a new or existing form or report, it must first open the form or report in Design view.

Zum Entfernen eines Steuerelements aus einem Formular oder Bericht verwenden Sie die Methoden DeleteControl und DeleteReportControl .To remove a control from a form or report, use the DeleteControl and DeleteReportControl methods.

BeispielExample

Im folgenden Beispiel wird zunächst ein neues Formular basierend auf der Tabelle „Bestellungen“ erstellt.The following example first creates a new form based on an Orders table. Anschließend wird mithilfe der CreateControl-Methode im Formular ein Textfeld-Steuerelement und ein zugeordnetes Bezeichnungsfeld-Steuerelement erstellt.It then uses the CreateControl method to create a text box control and an attached label control on the form.

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 FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.