Freigeben über

Schnittstellen und Steuerungsmuster

Listet die Microsoft UI Automation-Steuerelementmuster, die Klassen auf, die Clients für den Zugriff auf sie verwenden, und die Schnittstellenanbieter, die sie zum Implementieren verwenden.

In der Tabelle in diesem Thema werden die Steuerelementmuster der Microsoft-Benutzeroberflächenautomatisierung beschrieben. In der Tabelle sind auch die Klassen aufgeführt, die von Benutzeroberflächenautomatisierungs-Clients verwendet werden, um auf die Steuerelementmuster und die Schnittstellen zuzugreifen, die von Benutzeroberflächenautomatisierungs-Anbietern verwendet werden, um sie zu implementieren. Die Spalte "Steuerelementmuster " zeigt den Musternamen aus der Perspektive des Benutzeroberflächenautomatisierungs-Clients als konstanten Wert an, der in Steuerelementmusterverfügbarkeitseigenschafts-IDs aufgeführt ist. Aus Sicht des Benutzeroberflächenautomatisierungs-Anbieters ist jedes dieser Muster ein PatternInterface-Konstantenname . In der Schnittstellenspalte "Klassenanbieter " wird der Name der Schnittstelle angezeigt, die anbieter implementieren, um dieses Muster für ein benutzerdefiniertes XAML-Steuerelement bereitzustellen.

Hinweis

Verwenden Sie für WinUI-Apps, die mit dem Windows App SDK erstellt wurden, die Schnittstellen in Microsoft.UI.Xaml.Automation.Provider. Wenn Sie eine ältere UWP-Codebasis verwalten, gibt es entsprechende Schnittstellen in Windows.UI.Xaml.Automation.Provider.

Weitere Informationen zum Implementieren von benutzerdefinierten Automatisierungspeers, die Steuerelementmuster verfügbar machen und die Schnittstellen implementieren, finden Sie unter Benutzerdefinierte Automatisierungspeers.

Wenn Sie ein Steuerungsmuster implementieren, sollten Sie sich auch in der Dokumentation des UI-Automatisierungsanbieters informieren, in der einige der Erwartungen erläutert werden, die Clients an ein Steuerungsmuster stellen, unabhängig davon, welches Benutzeroberflächen-Framework für dessen Implementierung verwendet wird. Einige der Informationen, die in der generellen Dokumentation zum UI-Automatisierungsanbieter aufgeführt sind, beeinflussen, wie Sie Ihre Kollegen implementieren und die Muster ordnungsgemäß unterstützen. Siehe Implementieren von Steuerelementmustern für die Benutzeroberflächenautomatisierung, und zeigen Sie die Seite an, auf der das Muster dokumentiert wird, das Sie implementieren möchten.

Steuerungsmuster WinUI-Anbieterschnittstelle Veraltete UWP-Entsprechung Beschreibung
Annotation IAnnotationProvider IAnnotationProvider Wird verwendet, um die Eigenschaften einer Anmerkung in einem Dokument verfügbar zu machen.
Dock Idockprovider Idockprovider Wird für Steuerelemente verwendet, die in einem Andockcontainer verankert werden können. Beispielsweise Symbolleisten oder Werkzeugpaletten.
Ziehen IDragProvider IDragProvider Wird verwendet, um ziehbare Steuerelemente oder Steuerelemente mit ziehbaren Elementen zu unterstützen.
DropTarget IDropTargetProvider IDropTargetProvider Wird verwendet, um Steuerelemente zu unterstützen, die das Ziel eines Drag-and-Drop-Vorgangs sein können.
ExpandCollapse IExpandCollapseProvider IExpandCollapseProvider Wird verwendet, um Steuerelemente zu unterstützen, die visuell erweitert werden, um mehr Inhalte anzuzeigen und wieder zusammenzufalten, um Inhalte auszublenden.
Raster Igridprovider Igridprovider Wird für Steuerelemente verwendet, die Rasterfunktionen unterstützen, z. B. Größenanpassung und Verschieben zu einer angegebenen Zelle. Beachten Sie, dass Das Raster selbst dieses Muster nicht implementiert, da es ein Layout bereitstellt, aber kein Steuerelement ist.
GridItem Igriditemprovider Igriditemprovider Wird für Steuerelemente mit Zellen innerhalb von Gittern verwendet.
aufrufen IInvokeProvider IInvokeProvider Wird für Steuerelemente verwendet, die aufgerufen werden können, z. B. eine Schaltfläche.
ItemContainer IItemContainerProvider IItemContainerProvider Ermöglicht Anwendungen das Auffinden eines Elements in einem Container, z. B. eine virtualisierte Liste.
MultipleView IMultipleViewProvider IMultipleViewProvider Wird für Steuerelemente verwendet, die zwischen mehreren Darstellungen derselben Gruppe von Informationen, Daten oder untergeordneten Elementen wechseln können.
ObjectModel IObjectModelProvider IObjectModelProvider Wird verwendet, um einen Zeiger auf das zugrunde liegende Objektmodell eines Dokuments verfügbar zu machen.
RangeValue Irangevalueprovider Irangevalueprovider Wird für Steuerelemente mit einem Bereich von Werten verwendet, die auf das Steuerelement angewendet werden können. Ein Drehfeld-Steuerelement mit Jahren kann z. B. einen Bereich von 1900 bis zum aktuellen Jahr aufweisen, während ein weiteres Drehfeldsteuerelement, das Monate darstellt, einen Bereich von 1 bis 12 aufweisen würde.
Scroll IScrollProvider IScrollProvider Wird für Steuerelemente verwendet, die scrollen können. Beispielsweise ein Steuerelement mit Bildlaufleisten, die aktiv sind, wenn mehr Informationen vorhanden sind, als im sichtbaren Bereich des Steuerelements angezeigt werden können.
ScrollItem IScrollItemProvider IScrollItemProvider Wird für Steuerelemente verwendet, die einzelne Elemente in einer scrollenden Liste haben. Beispielsweise ein Listensteuerelement, das über einzelne Elemente in der Bildlaufliste verfügt, z. B. ein Kombinationsfeld-Steuerelement.
Auswahl Iselectionprovider Iselectionprovider Wird für Steuerelemente von Auswahlcontainern verwendet. Beispiel: ListBox und ComboBox.
Selectionitem ISelectionItemProvider ISelectionItemProvider Wird für einzelne Elemente in Auswahlcontainersteuerelementen verwendet, z. B. Listenfelder und Kombinationsfelder.
Tabelle ISpreadsheetProvider ISpreadsheetProvider Wird verwendet, um den Inhalt einer Kalkulationstabelle oder eines anderen rasterbasierten Dokuments verfügbar zu machen.
SpreadsheetItem ISpreadsheetItemProvider ISpreadsheetItemProvider Wird verwendet, um die Eigenschaften einer Zelle in einer Kalkulationstabelle oder einem anderen rasterbasierten Dokument verfügbar zu machen.
Styles IStylesProvider IStylesProvider Wird verwendet, um ein UI-Element mit einer bestimmten Formatvorlage, Füllfarbe, Füllmuster oder Form zu beschreiben.
SynchronizedInput ISynchronizedInputProvider ISynchronizedInputProvider Ermöglicht Benutzeroberflächenautomatisierungs-Client-Apps, die Maus- oder Tastatureingabe an ein bestimmtes UI-Element zu leiten.
Tabelle Itableprovider Itableprovider Wird für Steuerelemente verwendet, die über ein Raster und Kopfzeileninformationen verfügen. Beispiel: ein tabellarisches Kalendersteuerelement.
TableItem ITableItemProvider ITableItemProvider Wird für Elemente in einer Tabelle verwendet.
Text ITextProvider ITextProvider Wird für Bearbeitungssteuerelemente und Dokumente verwendet, die Textinformationen verfügbar machen. Siehe auch ITextRangeProvider und ITextProvider2.
TextChild ITextChildProvider ITextChildProvider Wird verwendet, um auf den nächsten Vorgänger eines Elements zuzugreifen, der das Textsteuerungsmuster unterstützt.
Textedit Keine verwaltete Klasse verfügbar Keine verwaltete Klasse verfügbar Bietet Zugriff auf ein Steuerelement, das Text ändert, z. B. ein Steuerelement, das die automatische Korrektur durchführt oder die Eingabekomposition über einen Eingabemethoden-Editor (IME) ermöglicht.
TextRange ITextRangeProvider ITextRangeProvider Bietet Zugriff auf eine Spanne von fortlaufendem Text in einem Textcontainer, der ITextProvider implementiert. Siehe auch ITextRangeProvider2.
Toggle Itoggleprovider Itoggleprovider Wird für Steuerelemente verwendet, bei denen der Zustand umgeschaltet werden kann. Beispielsweise CheckBox - und Menüelemente, die überprüft werden können.
Transform ITransformProvider ITransformProvider Wird für Steuerelemente verwendet, deren Größe geändert, verschoben und gedreht werden können. Typische Verwendungsmöglichkeiten des Transformationssteuerelementmusters sind in Designern, Formularen, grafischen Editoren und Zeichenanwendungen.
Wert IValueProvider IValueProvider Ermöglicht Kunden das Abrufen oder Festlegen eines Werts für Steuerelemente, die keinen Wertebereich unterstützen.
VirtualizedItem IVirtualizedItemProvider IVirtualizedItemProvider Macht Elemente in Containern verfügbar, die virtualisiert sind und vollständig als Benutzeroberflächenautomatisierungs-Elemente zugänglich gemacht werden müssen.
Fenster IWindowProvider IWindowProvider Stellt Windows-spezifische Informationen bereit, ein grundlegendes Konzept des Microsoft Windows-Betriebssystems. Beispiele für Steuerelemente, die Fenster sind, wie untergeordnete Fenster und Dialogfelder.

Hinweis

Nicht alle diese Muster werden von vorhandenen XAML-Steuerelementen implementiert. Einige Musterschnittstellen sind nur vorhanden, um die Parität mit den Musterdefinitionen des allgemeinen Benutzeroberflächenautomatisierungs-Frameworks aufrechtzuerhalten und Automatisierungspeersszenarien zu unterstützen, die eine vollständig benutzerdefinierte Implementierung erfordern.

  • Last updated on