Controls-Objekt (Access)
Die Controls-Auflistung enthält alle Steuerelemente in einem Formular, Bericht oder Unterformular, in einem anderen Steuerelement oder an ein anderes Steuerelement angefügt. Die Controls-Auflistung ist ein Element der Objekte Form, Report und SubForm .
Sie können einzelne Steuerelemente auflisten, zählen und ihre Eigenschaften in der Controls-Auflistung festlegen. Sie können z. B. die Controls-Auflistung eines bestimmten Formulars auflisten und die Height-Eigenschaft jedes Steuerelements auf einen angegebenen Wert festlegen.
Es ist schneller, implizit auf die Controls-Auflistung zu verweisen, wie in den folgenden Beispielen, die auf ein Steuerelement namens NewData in einem Formular namens OrderForm verweisen. Of the following syntax examples, Me!NewData
is the fastest way to refer to the control.
Me!NewData ' Or Forms!OrderForm!NewData.
Me![New Data] ' Use if control name contains space.
Me("NewData") ' Performance is slightly slower.
Sie können auch auf ein einzelnes Steuerelement verweisen, indem Sie explizit auf die Controls-Auflistung verweisen.
Me.Controls!NewData ' Or Forms!OrderForm.Controls!NewData.
Me.Controls![New Data]
Me.Controls("NewData")
Darüber hinaus können Sie auf ein Steuerelement durch seinen Index in der Auflistung verweisen. Die Controls-Auflistung wird beginnend mit 0 (null) indiziert.
Me(0) ' Refer to first item in collection.
Me.Controls(0)
Hinweis
Verwenden Sie die Me-Schlüsselwort (keyword), um ein Formular oder einen Bericht im Code nur darzustellen, wenn Sie auf das Formular oder den Bericht aus Code innerhalb des Formularmoduls oder Berichtsmoduls verweisen. Wenn Sie auf ein Formular oder einen Bericht aus einem Standardmodul oder dem Modul eines anderen Formulars oder Berichts verweisen, müssen Sie den vollständigen Verweis auf das Formular oder den Bericht verwenden.
Um mit den Steuerelementen in einem Abschnitt eines Formulars oder Berichts zu arbeiten, verwenden Sie die Section-Eigenschaft , um einen Verweis auf ein Section-Objekt zurückzugeben. Sie können dann auf die Controls-Auflistung des Section-Objekts verweisen.
Zwei Arten von Controls-Objekten, die Registersteuerelement und das Optionsgruppensteuerelement, weisen Controls-Sammlungen auf, die mehrere Steuerelemente enthalten können. Die Controls-Auflistung, die zum Optionsgruppensteuerelement gehört, enthält ein Optionsfeld, ein Kontrollkästchen, eine Umschaltfläche oder Label-Steuerelemente in der Optionsgruppe.
Das Registerkartensteuerelement enthält eine Pages-Auflistung , bei der es sich um einen speziellen Typ der Controls-Auflistung handelt. Die Pages-Auflistung enthält Page -Objekte. Bei Page-Objekten handelt es sich ebenfalls um Steuerelemente. Die Konstante der ControlType -Eigenschaft für ein Page-Steuerelement lautet acPage. Ein Page-Objekt wiederum besitzt eine eigene Controls-Auflistung, die alle Steuerelemente einer einzelnen Seite enthält.
Andere Control-Objekte haben eine Controls-Auflistung, die ein beigefügtes Bezeichnungsfeld enthalten kann. Diese Steuerelemente schließen Textfeld-, Optionsgruppen-, Optionsfeld-, Umschaltfläche-, Kontrollkästchen-, Kombinationsfeld-, Listenfeld-, Befehlsschaltfläche-, Gebundenes Objektfeld- und Objektfeld-Steuerelemente ein.
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.