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 dem Benutzer einfach ein bestimmtes Formular erstellen können.For example, suppose you are building a custom wizard that allows users to easily construct a particular form. Sie können die CreateControl-Methode in Ihrem Assistenten verwenden, um die entsprechenden Steuerelemente zum Formular hinzuzufügen.You can use the CreateControl method in your wizard to add the appropriate controls to the form.

SyntaxSyntax

Ausdruck. CreateControl (Formularname, ControlType, Abschnitt, übergeordneten, ColumnName, Links, oben, Breite, Höhe)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 Steuerelements darstellt, die Sie erstellen möchten.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 enthalten soll.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 bei Steuerelementen, die ohne übergeordnetes Steuerelement eine leere Zeichenfolge für dieses Argument oder weglassen.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, dem das Steuerelement gebunden wird, ist dies ein datengebundenes Steuerelement handeln soll.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 linke obere 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

BemerkungenRemarks

Die Methoden CreateControl und CreateReportControl können in einem benutzerdefinierten Assistenten zum Erstellen von Steuerelementen in einem Formular oder Bericht.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 übergeordnete Argument, um die Beziehung zwischen einem Hauptfenster Steuerelement und einem untergeordneten Steuerelement zu identifizieren.You use the Parent argument to identify the relationship between a main control and a subordinate control. Wenn ein Textfeld beispielsweise über eine angefügte Bezeichnung verfügt, ist das Textfeld das Hauptsteuerelement (übergeordnetes Steuerelement) und die Bezeichnung 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. Wenn Sie das Label-Steuerelement erstellen, legen Sie dessen Argument übergeordnet auf eine Zeichenfolge, 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. Wenn Sie das Textfeld erstellen, legen Sie dessen Argument übergeordnet auf eine leere Zeichenfolge.When you create the text box, set its Parent argument to a zero-length string.

Das Argument übergeordnet stellen Sie auch beim Erstellen von Kontrollkästchen, Optionsschaltflächen oder Umschaltflächen ein.You also set the Parent argument when you create check boxes, option buttons, or toggle buttons. Eine Optionsgruppe ist das übergeordnete Steuerelement von Kontrollkästchen, Optionsfeldern oder Umschaltflächen, die sie enthält.An option group is the parent control of any check boxes, option buttons, or toggle buttons that it contains. Die einzigen Steuerelemente, die über ein übergeordnetes Steuerelement verfügen können, sind Bezeichnungen, Kontrollkästchen, Optionsfelder oder Umschaltflächen.The only controls that can have a parent control are a label, check box, option button, or toggle button. All diese Steuerelemente können auch unabhängig, ohne ein übergeordnetes Steuerelement erstellt werden.All of these controls can also be created independently, without a parent control.

Legen Sie das Argument Spaltenname entsprechend den Typ des Steuerelements, die Sie erstellen und davon, 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 möglicherweise an ein Feld gebunden werden können, umfassen Textfelder, Listenfelder, Kombinationsfelder, Optionsgruppen und gebundene Objektfelder.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 sind möglicherweise Umschaltflächen, Optionsfelder und Kontrollkästchen an ein Feld gebunden, 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 für das Argument Spaltenname den Namen eines Felds angeben, erstellen Sie ein Steuerelement, das an das 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.

Um ein Steuerelement aus einem Formular oder Bericht entfernen möchten, verwenden Sie die DeleteControl und DeleteReportControl -Methode.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.