Report. DefaultControl-Eigenschaft (Access)Report.DefaultControl property (Access)

Die DefaultControl -Eigenschaft gibt ein Control -Objekt zurück, mit dem Sie die Standardeigenschaften für einen bestimmten Steuerelementtyp in einem bestimmten Bericht festlegen können.The DefaultControl property returns a Control object with which you can set the default properties for a particular type of control on a particular report. Schreibgeschützt.Read-only.

SyntaxSyntax

Ausdruck. DefaultControl (ControlType)expression.DefaultControl (ControlType)

Ausdruck Eine Variable, die ein Report -Objekt darstellt.expression A variable that represents a Report object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
ControlTypeControlType ErforderlichRequired LongLong Eine AcControlType -Konstante, die den Typ des Steuerelements angibt, für das die Standardeigenschafteneinstellungen festgelegt werden sollen.An AcControlType constant that indicates the type of control for which default property settings are to be set.

BemerkungenRemarks

Die DefaultControl-Eigenschaft ermöglicht es Ihnen, die Standardeigenschaften eines Steuerelements über den Code festzulegen.The DefaultControl property enables you to set a control's default properties from code. Nachdem Sie die Standardeigenschaften für einen bestimmten Steuerelementtyp festgelegt haben, haben alle anschließend erstellten Steuerelemente dieses Typs dieselben Standardwerte.After you have set the default properties for a particular type of control, each subsequently created control of that type will have the same default values.

Wenn Sie beispielsweise die FontSize-Eigenschaft der standardmäßigen Befehlsschaltfläche auf 12 festlegen, verfügt jede neue Befehlsschaltfläche über einen Schriftgrad von 12 Punkten.For example, if you set the FontSize property of the default command button to 12, each new command button will have a font size of 12 points.

Nicht alle Eigenschaften eines Steuerelements sind als Standardeigenschaften verfügbar.Not all of a control's properties are available as default properties. Die für ein Steuerelement verfügbaren Standardeigenschaften hängen vom Typ des Steuerelements ab.The default properties available for a control depend on the type of control.

Die DefaultControl -Eigenschaft gibt ein Control -Objekt des durch das ControlType -Argument angegebenen Typs zurück.The DefaultControl property returns a Control object of the type specified by the ControlType argument. Dieses Control-Objekt stellt kein tatsächliches Steuerelement eines Formulars dar, sondern ein Standardsteuerelement, das als Vorlage für alle anschließend erstellten Steuerelemente dieses Typs dient.This Control object doesn't represent an actual control on a form, but rather a default control that is a template for all subsequently created controls of that type. Sie legen die Standard-Steuerelementeigenschaften für das von der DefaultControl-Eigenschaft zurückgegebene Control-Objekt auf die gleiche Weise fest wie die Eigenschaften für ein Steuerelement eines Formulars.You set the default control properties for the Control object returned by the DefaultControl property in the same manner that you would set properties for an individual control on a form.

Die DefaultControl-Eigenschaft kann nur in der Formularentwurfsansicht oder der Berichtentwurfsansicht verwendet werden.The DefaultControl property can be used only in form Design view or report Design view. Beim Versuch, diese Eigenschaft auf ein Formular oder auf einen Bericht anzuwenden, das oder der sich nicht in der Entwurfsansicht befinden, resultiert daraus ein Laufzeitfehler.If you try to apply this property to a form or report that is not in Design view, a run-time error will result.

Wenn Sie versuchen, eine Eigenschaft festzulegen, die nicht als Standardeigenschaft mit der DefaultControl-Eigenschaft festgelegt werden kann, ergibt sich ein Laufzeitfehler.If you try to set a property that can't be set as a default property with the DefaultControl property, a run-time error will result. Wenn Sie ermitteln möchten, welche Eigenschaften Standardeigenschaften sein können, müssen Sie die Properties-Auflistung des Control-Objekts auswerten, das von der DefaultControl-Eigenschaft zurückgegeben wird.To determine which properties can be default properties, list the Properties collection of the Control object returned by the DefaultControl property.

BeispielExample

Das folgende Beispiel erstellt ein neues Formular und verwendet die DefaultControl -Eigenschaft, um ein Control -Objekt zurückzugeben, das die Standardbefehlsschaltfläche darstellt.The following example creates a new form and uses the DefaultControl property to return a Control object that represents the default command button. In der Prozedur werden einige der Standardeigenschaften für die Befehlsschaltfläche festgelegt, und anschließend wird eine neue Befehlsschaltfläche im Formular erstellt.The procedure sets some of the default properties for the command button, and then creates a new command button on the form.

Sub SetDefaultProperties() 
 Dim frm As Form, ctlDefault As Control, ctlNew As Control 
 
 ' Create new form. 
 Set frm = CreateForm 
 ' Return Control object representing default command button. 
 Set ctlDefault = frm.DefaultControl(acCommandButton) 
 ' Set some default properties. 
 With ctlDefault 
 .FontWeight = 700 
 .FontSize = 12 
 .Width = 3000 
 .Height = 1000 
 End With 
 ' Create new command button. 
 Set ctlNew = CreateControl(frm.Name, acCommandButton, , , , 500, 500) 
 ' Set control's caption. 
 ctlNew.caption = "New Command Button" 
 ' 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.