Report.DefaultControl-Eigenschaft (Access)
Die DefaultControl-Eigenschaft gibt ein Control-Objekt zurück, mit dem Sie die Standardeigenschaften für einen bestimmten Steuerelementtyp für einen bestimmten Bericht festlegen können. Schreibgeschützt.
Syntax
Ausdruck. DefaultControl (ControlType)
Ausdruck Eine Variable, die ein Report-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| ControlType | Erforderlich | Long | Eine AcControlType-Konstante , die den Typ des Steuerelements angibt, für das Standardeigenschafteneinstellungen festgelegt werden sollen. |
Hinweise
Die DefaultControl-Eigenschaft ermöglicht es Ihnen, die Standardeigenschaften eines Steuerelements über den Code festzulegen. Nachdem Sie die Standardeigenschaften für einen bestimmten Steuerelementtyp festgelegt haben, weist jedes anschließend erstellte Steuerelement dieses Typs dieselben Standardwerte auf.
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.
Nicht alle Eigenschaften eines Steuerelements sind als Standardeigenschaften verfügbar. Die für ein Steuerelement verfügbaren Standardeigenschaften hängen vom Typ des Steuerelements ab.
Die DefaultControl-Eigenschaft gibt ein Control-Objekt des vom ControlType-Argument angegebenen Typs zurück. 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. 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.
Die DefaultControl-Eigenschaft kann nur in der Formularentwurfsansicht oder der Berichtentwurfsansicht verwendet werden. 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.
Wenn Sie versuchen, eine Eigenschaft festzulegen, die nicht als Standardeigenschaft mit der DefaultControl-Eigenschaft festgelegt werden kann, ergibt sich ein Laufzeitfehler. 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.
Beispiel
Im folgenden Beispiel wird ein neues Formular erstellt und die DefaultControl-Eigenschaft verwendet, um ein Control-Objekt zurückzugeben, das die Standardbefehlsschaltfläche darstellt. Die Prozedur legt einige der Standardeigenschaften für die Befehlsschaltfläche fest und erstellt dann eine neue Befehlsschaltfläche im Formular.
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 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.