Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung
Ein Steuerelementmuster ist eine Schnittstellenimplementierung, die einen bestimmten Aspekt der Funktionalität eines Steuerelements für Microsoft Benutzeroberflächenautomatisierung-Clientanwendungen verfügbar macht. Clients verwenden die Eigenschaften und Methoden, die über ein Steuerelementmuster verfügbar gemacht werden, um Informationen zu einer bestimmten Funktion des Steuerelements abzurufen oder einen bestimmten Aspekt des Steuerelementverhaltens zu bearbeiten. Ein Steuerelement, das eine tabellarische Schnittstelle darstellt, verwendet beispielsweise das Grid-Steuerelementmuster , um die Anzahl der Zeilen und Spalten in der Tabelle verfügbar zu machen und einem Client das Abrufen von Elementen aus der Tabelle zu ermöglichen.
Die Benutzeroberflächenautomatisierung verwendet Steuerelementmuster, um allgemeine Verhaltensweisen von Steuerelementen abzubilden. Beispielsweise verwenden Sie das Steuerelementmuster Invoke für Steuerelemente, die aufgerufen werden können, z. B. Schaltflächen, und das Scroll-Steuerelementmuster für Steuerelemente mit Bildlaufleisten, z. B. Listenfeldern, Listenansichten oder Kombinationsfelden. Da jedes Steuerelementmuster eine separate Funktionalität darstellt, können Steuerelementmuster kombiniert werden, um den vollständigen Satz von Funktionen zu beschreiben, die von einem bestimmten Steuerelement unterstützt werden.
Hinweis
Ein Aggregatsteuerelement wird mit untergeordneten Steuerelementen erstellt, die die Benutzeroberfläche für Funktionen bereitstellen, die vom übergeordneten Steuerelement verfügbar gemacht werden, und das übergeordnete Steuerelement sollte alle Steuerelementmuster implementieren, die in der Regel den untergeordneten Steuerelementen zugeordnet sind. Dagegen ist es nicht erforderlich, dass diese selben Steuerelementmuster durch die untergeordneten Steuerelemente implementiert werden.
Dieses Thema enthält folgende Abschnitte:
- Komponenten der Steuerelementmuster für Benutzeroberflächenautomatisierung
- Steuerungsmuster in Anbietern und Clients
- Dynamische Steuerelementmuster
- Steuerelementmuster und verwandte Schnittstellen
- Zugehörige Themen
Komponenten der Steuerelementmuster für Benutzeroberflächenautomatisierung
Steuerelementmuster unterstützen Methoden, Eigenschaften, Ereignisse und Beziehungen, die erforderlich sind, um eine diskrete Funktion zu definieren, die in einem Steuerelement verfügbar ist.
- Die Methoden ermöglichen es Benutzeroberflächenautomatisierungs-Clients, das Steuerelement zu bearbeiten.
- Die Eigenschaften und Ereignisse liefern Informationen über die Funktionalität und den Zustand des Steuerelements.
- Die Beziehung zwischen einem Benutzeroberflächenautomatisierung-Element und seinen übergeordneten Elementen, untergeordneten Elementen und Geschwistern beschreibt die Elementstruktur in der Benutzeroberflächenautomatisierung-Struktur.
Steuerelementmuster beziehen sich auf Steuerelemente, die sich ähnlich wie Schnittstellen auf COM-Objekte (Component Object Model) beziehen. In COM können Sie ein Objekt abfragen, um zu fragen, welche Schnittstellen es unterstützt, und diese Schnittstellen dann für den Zugriff auf Funktionen verwenden. In Benutzeroberflächenautomatisierung können Clients ein Steuerelement fragen, welche Steuerelementmuster es unterstützt, und dann mit dem Steuerelement über die Eigenschaften, Methoden, Ereignisse und Strukturen interagieren, die von den unterstützten Steuerelementmustern verfügbar gemacht werden.
Steuerungsmuster in Anbietern und Clients
Benutzeroberflächenautomatisierung Anbieter implementieren Steuerelementmusterschnittstellen, um das geeignete Verhalten für eine bestimmte Funktion verfügbar zu machen, die vom Steuerelement unterstützt wird. Diese Schnittstellen werden nicht direkt für Clients verfügbar gemacht, sondern vom Benutzeroberflächenautomatisierung Kern verwendet, um einen weiteren Satz von Clientschnittstellen zu implementieren. Beispielsweise macht ein Anbieter Scrollfunktionen für Benutzeroberflächenautomatisierung über IScrollProvider verfügbar, und Benutzeroberflächenautomatisierung macht die Funktionalität über IUIAutomationScrollPattern für Clients verfügbar.
Dynamische Steuerelementmuster
Einige Steuerelemente unterstützen nicht immer denselben Satz von Steuerelementmustern. Beispielsweise ermöglicht ein Mehrzeilenbearbeitungssteuerelement das vertikale Scrollen nur, wenn es mehr Textzeilen enthält, als im sichtbaren Bereich angezeigt werden kann. Scrollen wird deaktiviert, wenn so viel Text entfernt wurde, dass kein Scrollen mehr erforderlich ist. In diesem Beispiel wird IUIAutomationScrollPattern dynamisch unterstützt, je nachdem, wie viel Text sich im Bearbeitungsfeld befindet.
Steuerelementmuster und verwandte Schnittstellen
In der folgenden Tabelle werden die Steuerelementmuster der Benutzeroberflächenautomatisierung beschrieben. Die Tabelle enthält auch die Anbieterschnittstellen, die zum Implementieren der Steuerelementmuster verwendet werden, und die Clientschnittstellen, die für den Zugriff verwendet werden.
Name | Anbieterschnittstelle | Clientschnittstelle | BESCHREIBUNG |
---|---|---|---|
Anmerkung | IAnnotationProvider | IUIAutomationAnnotationPattern | Wird verwendet, um die Eigenschaften einer Anmerkung in einem Dokument verfügbar zu machen, z. B. Kommentare am Rand, die mit Dokumenttext verbunden sind. |
Andocken | IDockProvider | IUIAutomationDockPattern | Wird für Steuerelemente verwendet, die in einem Andockcontainer angedockt werden können, z. B. Symbolleisten oder Werkzeugpaletten. |
Ziehen | IDragProvider | IUIAutomationDragPattern | Wird zum Unterstützen von ziehbaren Steuerelementen bzw. Steuerelementen mit ziehbaren Elementen verwendet. |
DropTarget | IDropTargetProvider | IUIAutomationDropTargetPattern | Wird zum Unterstützen von Steuerelementen verwendet, die Ziel eines Drag & Drop-Vorgangs sein können. |
ExpandCollapse | IExpandCollapseProvider | IUIAutomationExpandCollapsePattern | Wird für Steuerelemente verwendet, die erweitert oder reduziert werden können, z. B. Menüelemente in einer Anwendung, z. B. das Menü Datei. |
Grid | IGridProvider | IUIAutomationGridPattern | Wird für Steuerelemente verwendet, die Rasterfunktionen unterstützen, z. B. die Größenanpassung und das Verschieben in eine angegebene Zelle, z. B. die Ansicht mit großen Symbolen in Windows Explorer oder einfache Tabellen in Microsoft Office Word. |
GridItem | IGridItemProvider | IUIAutomationGridItemPattern | Wird für Steuerelemente verwendet, die Zellen in Rastern enthalten. Die einzelnen Zellen sollten das GridItem-Muster unterstützen, z. B. jede Zelle in Windows Explorer Detailansicht. |
Invoke | IInvokeProvider | IUIAutomationInvokePattern | Wird für Steuerelemente verwendet, die aufgerufen werden können, z. B. Schaltflächen. |
ItemContainer | IItemContainerProvider | IUIAutomationItemContainerPattern | Wird für Steuerelemente verwendet, die andere Elemente enthalten können. |
LegacyIAccessible | ILegacyIAccessibleProvider | IUIAutomationLegacyIAccessiblePattern | Wird verwendet, um Microsoft Active Accessibility-Eigenschaften und -Methoden für Benutzeroberflächenautomatisierung-Clients verfügbar zu machen. |
MultipleView | IMultipleViewProvider | IUIAutomationMultipleViewPattern | Wird für Steuerelemente verwendet, die zwischen mehreren Darstellungen derselben Gruppe von Informationen, Daten oder untergeordneten Elementen wechseln können, z. B. ein Listenansichtssteuerelement, bei dem Daten in Miniaturansichten, Kacheln, Symbolen, Listen- oder Detailansichten verfügbar sind. |
ObjectModel | IObjectModelProvider | IUIAutomationObjectModelPattern | Wird verwendet, um für das zugrunde liegende Objektmodell eines Dokuments einen Zeiger verfügbar zu machen. Dieses Steuerelementmuster ermöglicht es einem Client, von einem Benutzeroberflächenautomatisierung-Element zum zugrunde liegenden Objektmodell zu navigieren. |
RangeValue | IRangeValueProvider | IUIAutomationRangeValuePattern | Wird für Steuerelemente verwendet, die einen Wertebereich aufweisen. Beispielsweise kann ein Spinnersteuerelement, das Jahre anzeigt, einen Bereich von 1900 bis 2010 aufweisen, während ein Spinnersteuerelement, das Monate anzeigt, einen Bereich von 1 bis 12 aufweisen würde. |
Scrollen | IScrollProvider | IUIAutomationScrollPattern | Wird für Steuerelemente verwendet, die scrollen können, wenn mehr Informationen vorhanden sind, als im sichtbaren Bereich des Steuerelements angezeigt werden können. |
ScrollItem | IScrollItemProvider | IUIAutomationScrollItemPattern | Wird für Steuerelemente verwendet, die einzelne Elemente in einer Liste enthalten, die einen Bildlauf durchführt, z. B. ein Listensteuerelement in einem Kombinationsfeldsteuerelement. |
Auswahl | ISelectionProvider | IUIAutomationSelectionPattern | Wird für Auswahlcontainersteuerelemente verwendet, z. B. Listenfelder und Kombinationsfelder. |
SelectionItem | ISelectionItemProvider | IUIAutomationSelectionItemPattern | Wird für einzelne Elemente in Auswahlcontainer-Steuerelementen verwendet, z. B. Listen- und Kombinationsfelder. |
Spreadsheet | ISpreadsheetProvider | IUIAutomationSpreadsheetPattern | Wird verwendet, um den Inhalt einer Tabellenkalkulation oder eines anderen rasterbasierten Dokuments verfügbar zu machen. Steuerelemente, die das Spreadsheet-Steuerelementmuster implementieren, sollten auch das Grid-Steuerelementmuster implementieren. |
SpreadsheetItem | ISpreadsheetItemProvider | IUIAutomationSpreadsheetItemPattern | Wird verwendet, um die Eigenschaften einer Zelle in einer Tabellenkalkulation oder einem anderen rasterbasierten Dokument verfügbar zu machen. Steuerelemente, die das SpreadsheetItem-Steuerelementmuster implementieren, sollten auch das GridItem-Steuerelementmuster implementieren. |
Stile | IStylesProvider | IUIAutomationStylesPattern | 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 | IUIAutomationSynchronizedInputPattern | Wird für Steuerelemente verwendet, die Tastatur- oder Mauseingaben akzeptieren. |
Tabelle | ITableProvider | IUIAutomationTablePattern | Wird für Steuerelemente verwendet, die über ein Raster und Headerinformationen verfügen. |
TableItem | ITableItemProvider | IUIAutomationTableItemPattern | Wird für Elemente in einer Tabelle verwendet. |
Text | ITextProvider | IUIAutomationTextPattern | Wird für Bearbeitungssteuerelemente und Dokumente verwendet, die Textinformationen verfügbar machen. |
TextEdit | ITextEditProvider | IUIAutomationTextEditPattern | Wird zum Bearbeiten von Steuerelementen verwendet, die Text programmgesteuert ändern, z. B. ein Steuerelement, das eine automatische Korrektur durchführt oder die Eingabekomposition aktiviert. |
TextChild | ITextChildProvider | IUIAutomationTextChildPattern | Wird für den Zugriff auf den nächstgelegenen Vorgänger eines Elements verwendet, der das Text-Steuerelementmuster unterstützt. |
Textbereich | ITextRangeProvider | IUIAutomationTextRange | Wird zum Abrufen von Textinhalten, Textattributen und eingebetteten Objekten aus textbasierten Steuerelementen verwendet, z. B. zum Bearbeiten von Steuerelementen und Dokumenten. |
Ein-/Ausschalten | IToggleProvider | IUIAutomationTogglePattern | Wird für Steuerelemente verwendet, bei denen der Zustand umgeschaltet werden kann, z. B. Kontrollkästchen und anknutzbare Menüelemente. |
Transformieren | ITransformProvider | IUIAutomationTransformPattern | 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 | IUIAutomationValuePattern | Wird für Steuerelemente verwendet, die über einen Wert verfügen, der nicht innerhalb eines angegebenen Bereichs liegt, z. B. eine Datum-Uhrzeit-Auswahl. |
VirtualizedItem | IVirtualizedItemProvider | IUIAutomationVirtualizedItemPattern | Wird für Steuerelemente verwendet, die mit Elementen in einer virtuellen Liste arbeiten. |
Fenster | IWindowProvider | IUIAutomationWindowPattern | Wird für Fenster verwendet. Beispiele sind Anwendungsfenster der obersten Ebene, untergeordnete MDI-Fenster (Multiple Document Interface) und Dialogfelder. |
Zugehörige Themen
-
Konzept
-
Implementieren von Benutzeroberflächenautomatisierung Steuerelementmustern
-
Zuordnen von Steuerelementmustern für Benutzeroberflächenautomatisierungs-Clients