Markieren Sie das Kontrollkästchen Englisch, um die englische Version dieses Artikels anzuzeigen. Sie können den englischen Text auch in einem Popup-Fenster einblenden, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

UI Automation Properties Overview

 
System_CAPS_noteHinweis

Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten Benutzeroberflächenautomatisierung-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Aktuelle Informationen zur Benutzeroberflächenautomatisierung finden Sie auf der Seite zur Windows-Automatisierungs-API: UI-Automatisierung.

Benutzeroberflächenautomatisierungs-Anbieter machen Eigenschaften von Microsoft-UI-Automatisierung-Elementen verfügbar. Diese Eigenschaften ermöglichen es Benutzeroberflächenautomatisierungs-Clientanwendungen, Informationen zu Bestandteilen der Benutzeroberfläche (User Interface, UI) (insbesondere Steuerelemente) zu ermitteln, wobei diese Informationen sowohl statische als auch dynamische Daten umfassen können.

In diesem Abschnitt finden Sie eine allgemeine Übersicht über Microsoft-UI-Automatisierung-Eigenschaften. Speziellere Informationen finden Sie in folgenden Themen:

Jede Eigenschaft wird mit einer Zahl und einem Namen bezeichnet. Die Namen von Eigenschaften werden nur zum Debuggen und zu Diagnosezwecken verwendet. Anbieter verwenden die numerischen IDs, um eingehende Eigenschaftenanforderungen zu kennzeichnen. Clientanwendungen verwenden dagegen, um die abzurufenden Eigenschaften zu kennzeichnen, nur AutomationProperty-Objekte, in denen die Zahl und der Name gekapselt werden.

AutomationProperty-Objekte, die bestimmte Eigenschaften darstellen, sind als Felder in verschiedenen Klassen verfügbar. Aus Sicherheitsgründen rufen Benutzeroberflächenautomatisierungs-Anbieter diese Objekte aus einem separaten Satz von Klassen ab, die in „Uiautomationtypes.dll“ enthalten sind.

In folgender Tabelle sind Eigenschaften anhand der Klassen kategorisiert, die die AutomationProperty-IDs enthalten.

Arten von Eigenschaften

Clients rufen IDs ab von

Anbieter rufen IDs ab von

Eigenschaften, die jedes der Elemente hat (siehe folgende Tabellen)

AutomationElement

AutomationElementIdentifiers

Position eines andockbaren Fensters

DockPattern

DockPatternIdentifiers

Zustand eines Elements, das erweitert und reduziert werden kann

ExpandCollapsePattern

ExpandCollapsePatternIdentifiers

Eigenschaften eines Elements in einem Raster

GridItemPattern

GridItemPatternIdentifiers

Eigenschaften eines Rasters

GridPattern

GridPatternIdentifiers

Aktuelle und unterstützte Ansicht eines Elements, das mehrere Ansichten hat

MultipleViewPattern

MultipleViewPatternIdentifiers

Eigenschaften eines Elements, das innerhalb eines Wertebereichs verschoben werden kann, etwa ein Schieberegler

RangeValuePattern

RangeValuePatternIdentifiers

Eigenschaften eines scrollbaren Fensters

ScrollPattern

ScrollPatternIdentifiers

Status und Container eines Elements, das ausgewählt werden kann, z. B. in einer Liste

SelectionItemPattern

SelectionItemPatternIdentifiers

Eigenschaften eines Steuerelements, das Auswahlelemente enthält

SelectionPattern

SelectionPatternIdentifiers

Spalten- und Zeilenüberschriften eines Elements in einer Tabelle

TableItemPattern

TableItemPatternIdentifiers

Spalten- und Zeilenüberschriften sowie Ausrichtung einer Tabelle

TablePattern

TablePatternIdentifiers

Zustand eines umschaltbaren Steuerelements

TogglePattern

TogglePatternIdentifiers

Funktionen eines Elements, das verschoben, gedreht oder in der Größe geändert werden kann

TransformPattern

TransformPatternIdentifiers

Wert und Lese-/Schreibfunktionen eines Elements, das einen Wert hat

ValuePattern

ValuePatternIdentifiers

Funktionen und Status eines Fensters

WindowPattern

WindowPatternIdentifiers

In den folgenden Tabellen sind die Eigenschaften kategorisiert, deren IDs in AutomationElement und AutomationElementIdentifiers zu finden sind. Diese Eigenschaften hat jedes der Steuerelemente. Bis auf einige Ausnahmen sind wahrscheinlich alle diese Eigenschaften während der gesamten Lebensdauer der Anbieteranwendung statisch. Die meisten dynamischen Eigenschaften sind mit Steuerelementmustern verknüpft.

In der Spalte Eigenschaftenzugriff werden zusätzlich zu GetCurrentPropertyValue und GetCachedPropertyValue alle weiteren Accessoren für jede Eigenschaft aufgeführt. Weitere Informationen zum Abrufen von Eigenschaften in einer Clientanwendung finden Sie unter UI Automation Properties for Clients.

System_CAPS_noteHinweis

Spezielle Informationen zu jeder Eigenschaft finden Sie über den Link in der Spalte Eigenschaftenzugriff.

Anzeigen von Merkmalen

Eigenschaftenbezeichner

Eigenschaftenzugriff

BoundingRectangleProperty

BoundingRectangle

CultureProperty

nicht verfügbar

HelpTextProperty

HelpText

IsOffscreenProperty

IsOffscreen

OrientationProperty

Orientation

Elementtyp

Eigenschaftenbezeichner

Eigenschaftenzugriff

ControlTypeProperty

ControlType

IsContentElementProperty

IsContentElement

IsControlElementProperty

IsControlElement

ItemTypeProperty

ItemType

LocalizedControlTypeProperty

LocalizedControlType

Identifikation

Eigenschaftenbezeichner

Eigenschaftenzugriff

AutomationIdProperty

AutomationId

ClassNameProperty

ClassName

FrameworkIdProperty

FrameworkId

LabeledByProperty

LabeledBy

NameProperty

Name

ProcessIdProperty

ProcessId

RuntimeIdProperty

GetRuntimeId

NativeWindowHandleProperty

NativeWindowHandle

Interaktion

Eigenschaftenbezeichner

Eigenschaftenzugriff

AcceleratorKeyProperty

AcceleratorKey

AccessKeyProperty

AccessKey

ClickablePointProperty

GetClickablePoint

HasKeyboardFocusProperty

HasKeyboardFocus

IsEnabledProperty

IsEnabled

IsKeyboardFocusableProperty

IsKeyboardFocusable

Unterstützung für Muster

Eigenschaftenbezeichner

Eigenschaftenzugriff

IsDockPatternAvailableProperty

GetSupportedPatterns

IsExpandCollapsePatternAvailableProperty

GetSupportedPatterns

IsGridItemPatternAvailableProperty

GetSupportedPatterns

IsGridPatternAvailableProperty

GetSupportedPatterns

IsInvokePatternAvailableProperty

GetSupportedPatterns

IsMultipleViewPatternAvailableProperty

GetSupportedPatterns

IsRangeValuePatternAvailableProperty

GetSupportedPatterns

IsScrollItemPatternAvailableProperty

GetSupportedPatterns

IsScrollPatternAvailableProperty

GetSupportedPatterns

IsSelectionItemPatternAvailableProperty

GetSupportedPatterns

IsSelectionPatternAvailableProperty

GetSupportedPatterns

IsTableItemPatternAvailableProperty

GetSupportedPatterns

IsTablePatternAvailableProperty

GetSupportedPatterns

IsTextPatternAvailableProperty

GetSupportedPatterns

IsTogglePatternAvailableProperty

GetSupportedPatterns

IsTransformPatternAvailableProperty

GetSupportedPatterns

IsValuePatternAvailableProperty

GetSupportedPatterns

IsWindowPatternAvailableProperty

GetSupportedPatterns

Sonstiges

Eigenschaftenbezeichner

Eigenschaftenzugriff

IsRequiredForFormProperty

IsRequiredForForm

IsPasswordProperty

IsPassword

ItemStatusProperty

ItemStatus

Benutzeroberflächenautomatisierung-Anbieter sollten folgende Eigenschaften in der Sprache des Betriebssystems zur Verfügung stellen:

Direkt verknüpft mit den Eigenschaften in Benutzeroberflächenautomatisierung ist das Konzept von Ereignissen aufgrund von geänderten Eigenschaften. Bei dynamischen Eigenschaften muss die Clientanwendung feststellen können, ob ein Eigenschaftswert geändert wurde. Nur dann kann sie die Informationen in ihrem Cache aktualisieren oder auf andere Weise auf die neuen Informationen reagieren.

Anbieter lösen Ereignisse aus, wenn irgendetwas in der UI geändert wurde. Wird zum Beispiel ein Kontrollkästchen aktiviert oder deaktiviert, wird von dem Umschaltmuster, das für den Anbieter implementiert ist, ein Ereignis entsprechend der Eigenschaftenänderung ausgelöst. Anbieter können abhängig davon, ob Clients Ereignissen oder bestimmten Ereignissen lauschen, selektiv Ereignisse auslösen.

Es werden nicht für alle Eigenschaftenänderung Ereignisse ausgelöst. Dies ist vollständig von der Implementierung des Benutzeroberflächenautomatisierungs-Anbieters für das Element abhängig. Die Standardproxyanbieter für Listenfelder lösen beispielsweise kein Ereignis aus, wenn SelectionProperty geändert wird. In diesem Fall muss die Anwendung einem ElementSelectedEvent lauschen.

Clients lauschen Ereignissen, indem sie diese abonnieren. Abonnieren von Ereignissen bedeutet, dass Delegatenmethoden erstellt werden, die Ereignisse verarbeiten können, und dass die Methoden anschließend zusammen mit den Ereignissen, die von diesen Methoden verarbeitet werden, an Benutzeroberflächenautomatisierung übergeben werden. Insbesondere für Ereignisse wegen geänderter Eigenschaften müssen Clients AutomationPropertyChangedEventHandler implementieren.

Anzeigen: