Freigeben über

Übersicht über benutzeroberflächenautomatisierungs-Eigenschaften

Hinweis

Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.

Benutzeroberflächenautomatisierungs-Anbieter machen Eigenschaften für Microsoft-Benutzeroberflächenautomatisierungs-Elemente verfügbar. Mit diesen Eigenschaften können Benutzeroberflächenautomatisierungs-Clientanwendungen Informationen über Teile der Benutzeroberfläche (UI) ermitteln, insbesondere Steuerelemente, einschließlich statischer und dynamischer Daten.

In diesem Abschnitt finden Sie eine allgemeine Übersicht über die Eigenschaften der Microsoft-Benutzeroberflächenautomatisierung. Spezifischere Informationen werden in den folgenden Themen erläutert:

Eigenschaftsbezeichner

Jedes Eigentum wird durch eine Zahl und einen Namen identifiziert. Die Namen von Eigenschaften werden nur für das Debuggen und die Diagnose verwendet. Anbieter verwenden die numerische IDs, um eingehende Objektanfragen zu identifizieren. Clientanwendungen verwenden jedoch nur AutomationProperty, welches die Nummer und den Namen kapselt, um Eigenschaften zu identifizieren, die sie abrufen möchten.

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.dllenthalten sind.

In der folgenden Tabelle werden Die Eigenschaften nach den Klassen kategorisiert, die die AutomationPropertyIDs enthalten.

Arten von Eigenschaften Clients erhalten Identifikationsnummern von Anbieter erhalten IDs von
Eigenschaften, die allen Elementen gemeinsam sind (siehe folgende Tabellen) AutomationElement AutomationElementIdentifiers
Position eines Andockfensters DockPattern DockPatternIdentifiers
Status eines Elements, das erweitert und zusammengeklappt werden kann ExpandCollapsePattern ExpandCollapsePatternIdentifiers
Eigenschaften eines Elements in einem Raster GridItemPattern GridItemPatternIdentifiers
Eigenschaften eines Rasters GridPattern GridPatternIdentifiers
Aktuelle und unterstützte Ansicht eines Elements mit mehreren Ansichten MultipleViewPattern MultipleViewPatternIdentifiers
Eigenschaften eines Elements, das sich über einen Wertebereich bewegt, z. B. ein Schieberegler RangeValuePattern RangeValuePatternIdentifiers
Eigenschaften eines Scrollfensters ScrollPattern ScrollPatternIdentifiers
Status und Container eines Elements, das ausgewählt werden kann, wie 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 und Ausrichtung einer Tabelle TablePattern TablePatternIdentifiers
Zustand eines umschaltbaren Steuerelements TogglePattern TogglePatternIdentifiers
Funktionen eines Elements, das verschoben, gedreht oder verkleinert werden kann TransformPattern TransformPatternIdentifiers
Wert und Lese-/Schreibfunktionen eines Elements, das einen Wert hat ValuePattern ValuePatternIdentifiers
Funktionen und Status eines Fensters WindowPattern WindowPatternIdentifiers

Eigenschaften nach Kategorie

Die folgenden Tabellen kategorisieren die Eigenschaften, deren IDs in AutomationElement und AutomationElementIdentifiers zu finden sind. Diese Eigenschaften gelten für alle Steuerelemente. Alle bis auf wenige davon sind wahrscheinlich im Verlauf der Lebensdauer der Anwendung des Anbieters statisch, die meisten dynamischen Eigenschaften sind Steuerelementmustern zugeordnet.

In der Spalte „Eigenschaftszugriff“ werden sämtliche übrigen Accessoren für jede Eigenschaft zusätzlich zu GetCurrentPropertyValue und GetCachedPropertyValue aufgelistet. Weitere Informationen zum Abrufen von Eigenschaften in einer Clientanwendung finden Sie unter Benutzeroberflächenautomatisierungseigenschaften für Clients.

Hinweis

Für bestimmte Informationen zu jeder Eigenschaft folgen Sie dem Link in der Spalte "Eigenschaftszugriff ".

Anzeigemerkmale

Grundstückskennzeichen Eigenschaftenzugriff
BoundingRectangleProperty BoundingRectangle
CultureProperty n/a
HelpTextProperty HelpText
IsOffscreenProperty IsOffscreen
OrientationProperty Orientation

Elementtyp

Grundstückskennzeichen Eigenschaftenzugriff
ControlTypeProperty ControlType
IsContentElementProperty IsContentElement
IsControlElementProperty IsControlElement
ItemTypeProperty ItemType
LocalizedControlTypeProperty LocalizedControlType

Identifikation

Grundstückskennzeichen Eigenschaftenzugriff
AutomationIdProperty AutomationId
ClassNameProperty ClassName
FrameworkIdProperty FrameworkId
LabeledByProperty LabeledBy
NameProperty Name
ProcessIdProperty ProcessId
RuntimeIdProperty GetRuntimeId
NativeWindowHandleProperty NativeWindowHandle

Wechselwirkung

Grundstückskennzeichen Eigenschaftenzugriff
AcceleratorKeyProperty AcceleratorKey
AccessKeyProperty AccessKey
ClickablePointProperty GetClickablePoint
HasKeyboardFocusProperty HasKeyboardFocus
IsEnabledProperty IsEnabled
IsKeyboardFocusableProperty IsKeyboardFocusable

Unterstützung für Muster

Grundstückskennzeichen 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

Verschiedenes

Grundstückskennzeichen Eigenschaftenzugriff
IsRequiredForFormProperty IsRequiredForForm
IsPasswordProperty IsPassword
ItemStatusProperty ItemStatus

Lokalisierung

Benutzeroberflächenautomatisierungs-Anbieter sollten die folgenden Eigenschaften in der Sprache des Betriebssystems darstellen:

Eigenschaften und Ereignisse

Eng mit den Eigenschaften in der Benutzeroberflächenautomatisierung verknüpft ist das Konzept von Eigenschaftsänderungsereignissen. Für dynamische Eigenschaften benötigt die Clientanwendung eine Möglichkeit, um zu wissen, dass sich ein Eigenschaftswert geändert hat, damit er seinen Informationscache aktualisieren oder auf andere Weise auf die neuen Informationen reagieren kann.

Anbieter lösen Ereignisse aus, wenn sich etwas in der Benutzeroberfläche ändert. 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.

Nicht alle Eigenschaftenänderungen lösen Ereignisse aus; das liegt ganz bei der Implementierung des Benutzeroberflächenautomatisierungs-Anbieters für das Element. Beispielsweise lösen die Standardproxyanbieter für Listenfelder kein Ereignis aus, wenn sich SelectionProperty ändert. In diesem Fall muss die Anwendung einem ElementSelectedEventlauschen.

Clients lauschen auf Ereignisse, indem sie sie abonnieren. Durch das Abonnieren von Ereignissen werden Delegatenmethoden erstellt, die Ereignisse verarbeiten können. Die Methoden werden anschließend zusammen mit den darin verarbeiteten Ereignissen an die Benutzeroberflächenautomatisierung übergeben. Insbesondere für Ereignisse wegen geänderter Eigenschaften müssen Clients AutomationPropertyChangedEventHandlerimplementieren.

Siehe auch

  • Last updated on