Freigeben über

Schnittstellen und Steuerungsmuster

Listet die Microsoft Benutzeroberflächenautomatisierung-Steuerelementmuster, die Klassen, die von Clients für den Zugriff verwendet werden, und die Schnittstellen, die von Anbietern zur Implementierung eingesetzt werden.

In der Tabelle in diesem Thema werden die Microsoft Benutzeroberflächenautomatisierung Steuerelementmuster beschrieben. In der Tabelle sind auch die Klassen aufgeführt, die von Benutzeroberflächenautomatisierung Clients verwendet werden, um auf die Steuerelementmuster und die Schnittstellen zuzugreifen, die von Benutzeroberflächenautomatisierung Anbietern verwendet werden, um sie zu implementieren. Die Spalte Control-Muster zeigt den Musternamen aus der Benutzeroberflächenautomatisierung Clientperspektive als konstanten Wert an, der in Control Pattern Availability Property Identifiers aufgeführt ist. Aus der Perspektive des Benutzeroberflächenautomatisierung Anbieters ist jedes dieser Muster ein PatternInterface-Konstantenname. In der Spalte Provider-Schnittstelle wird der Name der Microsoft.UI.Xaml.Automation.Provider-Schnittstelle angezeigt, die Anbieter implementieren, um dieses Muster für ein benutzerdefiniertes XAML-Steuerelement zu implementieren.

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

Wenn Sie ein Steuerelementmuster implementieren, sollten Sie auch die Dokumentation des UI-Automatisierungsanbieters konsultieren, die einige der Erwartungen der Clients an ein Steuerelementmuster erklärt, unabhängig davon, welches Benutzeroberflächen-Framework verwendet wird. Einige der Informationen, die in der allgemeinen Benutzeroberflächenautomatisierung Provider-Dokumentation aufgeführt sind, beeinflussen, wie Sie Ihre Peers implementieren und das Muster korrekt unterstützen. Siehe auch Implementing Benutzeroberflächenautomatisierung Steuerelementmuster, und öffnen Sie die Seite, die das Muster dokumentiert, 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ächenautomatisierung 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 als Benutzeroberflächenautomatisierung Elemente vollständig zugänglich gemacht werden müssen.
Fenster IWindowProvider IWindowProvider Macht spezifische Informationen für Windows verfügbar, 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ächenautomatisierung Frameworks aufrechtzuerhalten und Automatisierungspeerszenarien zu unterstützen, die eine vollständige benutzerdefinierte Implementierung erfordern.

  • Last updated on