Steuerelementmuster und Schnittstellen
Enthält eine Liste der Steuerelementmuster für die Microsoft-Benutzeroberflächenautomatisierung zusammen mit den Klassen, die Clients für den Zugriff verwenden, und den Schnittstellen, die Anbieter zur Implementierung verwenden.
In der Tabelle in diesem Thema werden die Steuerelementmuster der Microsoft-Benutzeroberflächenautomatisierung erläutert. Die Tabelle enthält außerdem die Klassen, die von Benutzeroberflächenautomatisierungs-Clients für den Zugriff auf die Steuerelementmuster verwendet werden, sowie die Schnittstellen, die Benutzeroberflächenautomatisierungs-Anbieter zu deren Implementierung nutzen. In der Spalte Steuerelementmuster wird der Mustername aus Sicht des Benutzeroberflächenautomatisierungs-Clients als Konstantenwert angezeigt, der in Eigenschaftsbezeichnern für die Verfügbarkeit von Steuerelementmustern aufgeführt wird. Aus Sicht des Benutzeroberflächenautomatisierungs-Anbieters ist jedes dieser Muster ein PatternInterface-Konstantenname. In der Spalte Schnittstelle für Klassenanbieter wird der Name der Windows-Runtime-Schnittstelle angezeigt, die von Anbietern implementiert wird, um dieses Muster für ein benutzerdefiniertes XAML-Steuerelement bereitzustellen.
Weitere Informationen zum Implementieren benutzerdefinierter Automatisierungspeers, von denen Steuerelementmuster verfügbar gemacht und die Schnittstellen implementiert werden, finden Sie unter Benutzerdefinierte Automatisierungspeers.
Beim Implementieren eines Steuerelementmusters sollten Sie auch die Dokumentation zum Benutzeroberflächenautomatisierungs-Anbieter heranziehen. Darin werden einige Erwartungen beschrieben, die Clients unabhängig davon, welches Benutzeroberflächenframework zum Implementieren verwendet wird, an ein Steuerelementmuster stellen. Einige Informationen, die in der allgemeinen Dokumentation zum Benutzeroberflächenautomatisierungs-Anbieter aufgeführt sind, haben Einfluss darauf, wie Sie Ihre Peers implementieren und das Muster richtig unterstützen. Lesen Sie sich die Informationen unter Implementieren von Steuerelementmustern für die Benutzeroberflächenautomatisierung durch, und zeigen Sie die Seite an, auf der das gewünschte Muster dokumentiert ist.
Steuerelementmuster | Schnittstelle für Klassenanbieter | BESCHREIBUNG |
---|---|---|
Anmerkung | IAnnotationProvider | Damit werden die Eigenschaften einer Anmerkung in einem Dokument verfügbar gemacht. |
Andocken | IDockProvider | Wird für Steuerelemente verwendet, die in einem Dockingcontainer angedockt werden können. Beispielsweise Symbolleisten oder Toolpaletten. |
Ziehen | IDragProvider | Wird zum Unterstützen von ziehbaren Steuerelementen bzw. Steuerelementen mit ziehbaren Elementen verwendet. |
DropTarget | IDropTargetProvider | Wird zum Unterstützen von Steuerelementen verwendet, die Ziel eines Drag & Drop-Vorgangs sein können. |
ExpandCollapse | IExpandCollapseProvider | Wird zum Unterstützen von Steuerelementen verwendet, die visuell erweitert oder reduziert werden, um mehr bzw. weniger Inhalt anzuzeigen. |
Grid | IGridProvider | Wird für Steuerelemente verwendet, die Rasterfunktionen wie z. B. Größenanpassung und Verschieben in eine bestimmte Zelle unterstützen. Beachten Sie, dass dieses Muster nicht vom Raster selbst implementiert wird. Dies liegt daran, dass das Raster zwar ein Layout bereitstellt, aber kein Steuerelement ist. |
GridItem | IGridItemProvider | Wird für Steuerelemente verwendet, die Zellen innerhalb von Rastern haben. |
Invoke | IInvokeProvider | Wird für Steuerelemente verwendet, die aufgerufen werden können, z. B. eine Schaltfläche. |
ItemContainer | IItemContainerProvider | Ermöglicht es Anwendungen, Elemente in einem Container (z. B. in einer virtualisierten Liste) zu finden. |
MultipleView | IMultipleViewProvider | Wird für Steuerelemente verwendet, die zwischen mehreren Darstellungen derselben Informationen, Daten oder untergeordneten Elemente wechseln können. |
ObjectModel | IObjectModelProvider | Wird verwendet, um für das zugrunde liegende Objektmodell eines Dokuments einen Zeiger verfügbar zu machen. |
RangeValue | IRangeValueProvider | Wird für Steuerelemente verwendet, die einen Bereich von Werten haben, die auf das Steuerelement angewendet werden können. So verfügt ein Drehfeld, das Jahre enthält, beispielsweise über einen Bereich von 1900 bis zum aktuellen Jahr. Ein anderes Drehfeld, das für Monate steht, würde jedoch über einen Bereich von 1 bis 12 verfügen. |
Scrollen | IScrollProvider | Wird für Steuerelemente verwendet, in denen gescrollt werden kann. Beispielsweise ein Steuerelement, das Scrollleisten hat, die nur aktiv sind, wenn mehr Informationen vorhanden sind, als im Anzeigebereich des Steuerelements angezeigt werden können. |
ScrollItem | IScrollItemProvider | Wird für Steuerelemente verwendet, die einzelne Elemente in einer Liste haben, die gescrollt werden kann. Beispielsweise ein Listensteuerelement, das einzelne Elementen in der Scrollliste hat, etwa ein Kombinationsfeld-Steuerelement. |
Auswahl | ISelectionProvider | Wird für Auswahlcontainer-Steuerelemente verwendet. Beispiel: ListBox und ComboBox. |
SelectionItem | ISelectionItemProvider | Wird für einzelne Elemente in Auswahlcontainer-Steuerelementen verwendet, z. B. Listen- und Kombinationsfelder. |
Spreadsheet | ISpreadsheetProvider | Wird verwendet, um den Inhalt einer Tabellenkalkulation oder eines anderen rasterbasierten Dokuments verfügbar zu machen. |
SpreadsheetItem | ISpreadsheetItemProvider | Wird verwendet, um die Eigenschaften einer Zelle in einer Tabellenkalkulation oder einem anderen rasterbasierten Dokument verfügbar zu machen. |
Stile | IStylesProvider | Wird verwendet, um ein UI-Element zu beschreiben, das in Bezug auf Stil, Füllfarbe, Füllmuster oder Form über bestimmte Einstellungen verfügt. |
SynchronizedInput | ISynchronizedInputProvider | Ermöglicht Benutzeroberflächenautomatisierungs-Client-Apps das Lenken der Maus- oder Tastatureingabe auf ein bestimmtes UI-Element. |
Tabelle | ITableProvider | Wird für Steuerelemente verwendet, die sowohl ein Raster als auch Überschrifteninformationen haben. Beispiel: ein Steuerelement für einen tabellarischen Kalender. |
TableItem | ITableItemProvider | Wird für Elemente in einer Tabelle verwendet. |
Text | ITextProvider | Wird für Bearbeitungssteuerelemente und Dokumente verwendet, die Textinformationen verfügbar machen. Siehe auch ITextRangeProvider und ITextProvider2. |
TextChild | ITextChildProvider | Wird für den Zugriff auf den nächstgelegenen Vorgänger eines Elements verwendet, der das Text-Steuerelementmuster unterstützt. |
TextEdit | Keine verwaltete Klasse verfügbar | Gewährt Zugriff auf ein Steuerelement, mit dem Text geändert wird. Dies kann beispielsweise ein Steuerelement sein, mit dem die Autokorrektur durchgeführt oder mithilfe eines Input Method Editors (IME) die Komposition der Eingabe ermöglicht wird. |
Textbereich | ITextRangeProvider | Bietet Zugriff auf einen Bereich mit fortlaufendem Text in einem Textcontainer, von dem ITextProvider implementiert wird. Siehe auch ITextRangeProvider2. |
Ein-/Ausschalten | IToggleProvider | Wird für Steuerelemente verwendet, deren Zustand umgeschaltet werden kann. Beispiel: aktivierbare CheckBox-Steuerelemente und Menüelemente. |
Transformieren | ITransformProvider | Wird für Steuerelemente verwendet, die in der Größe geändert, verschoben und gedreht werden können. Typische Einsatzfälle für das Transform-Steuerelementmuster sind Designer, Formulare, Grafik-Editoren und Zeichnungsanwendung. |
Wert | IValueProvider | Ermöglicht Clients das Abrufen oder Festlegen eines Werts für ein Steuerelement, das keinen Wertebereich unterstützt. |
VirtualizedItem | IVirtualizedItemProvider | Macht Elemente in Containern verfügbar, die virtualisiert sind und vollständig als Benutzeroberflächenautomatisierungs-Elemente zur Verfügung stehen müssen. |
Fenster | IWindowProvider | Macht für bestimmte Fenster spezifische Informationen verfügbar. Hierbei handelt es sich um ein grundlegendes Konzept des Microsoft Windows-Betriebssystems. Beispiele für Steuerelemente als Fenster: untergeordnete Fenster und Dialogfelder. |
Hinweis
Implementierungen all dieser Muster sind in vorhandenen XAML-Steuerelementen nicht immer enthalten. Einige Muster verfügen nur über Schnittstellen, um die Parität mit der allgemeinen Benutzeroberflächenautomatierungs-Frameworkdefinition für Muster sowie Automatisierungspeerszenarien zu unterstützen, die für die Unterstützung dieses Musters eine rein benutzerdefinierte Implementierung benötigen.
Hinweis
Windows Phone Store-Apps unterstützen nicht alle hier aufgeführten Steuerelementmuster der Benutzeroberflächenautomatisierung. Zu den nicht unterstützten Mustern zählen beispielsweise Annotation, Dock, Drag, DropTarget und ObjectModel.
Zugehörige Themen
Windows developer
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für