Freigeben über


Ü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

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.

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.

 

Konzept

Implementieren von Benutzeroberflächenautomatisierung Steuerelementmustern

Zuordnen von Steuerelementmustern für Benutzeroberflächenautomatisierungs-Clients