Freigeben über


Benutzeroberflächenautomatisierungs-Unterstützung für den Window-Steuerelementtyp

HinweisHinweis

Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

Dieses Thema enthält Informationen über die UI Automation-Unterstützung für den Window-Steuerelementtyp. Bei der UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

Das Window-Steuerelement besteht aus einem Fensterrahmen, der untergeordnete Objekte wie eine Titelleiste, Client und andere Objekte enthält.

Die UI Automation-Anforderungen in den folgenden Abschnitten gelten für alle Steuerelemente, die den Window-Steuerelementtyp implementieren. Dies können Windows Presentation Foundation (WPF)-, Win32- und Windows Forms-Steuerelemente sein.

Dieses Thema enthält folgende Abschnitte.

  • Erforderliche Benutzeroberflächenautomatisierungs-Struktur
  • Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
  • Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
  • Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
  • Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur für Window-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

Fenster

Fenster

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Wert oder Definition für Window-Steuerelemente besonders relevant ist. Weitere Informationen über UI Automation-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-Eigenschaft

Wert

Hinweise

AutomationIdProperty

Siehe Hinweise.

Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.

BoundingRectangleProperty

Siehe Hinweise.

Das äußere Rechteck, welches das gesamte Steuerelement umfasst.

ClickablePointProperty

Siehe Hinweise.

Das Window-Steuerelement muss über einen durch Klicken aktivierbaren Punkt verfügen, mit dem das Fenster ausgewählt bzw. die Auswahl des Fensters wieder aufgehoben werden kann.

ControlTypeProperty

Window

Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.

IsContentElementProperty

True

Das Window-Steuerelement muss stets ein Inhaltselement sein.

IsControlElementProperty

True

Das Window-Steuerelement muss stets ein Steuerelement sein.

IsKeyboardFocusableProperty

Siehe Hinweise.

Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.

LabeledByProperty

null

Window-Steuerelemente verfügen nicht über eine statische Fensterbezeichnung.

LocalizedControlTypeProperty

"window"

Lokalisierte Zeichenfolge, die dem Window-Steuerelementtyp entspricht.

NameProperty

Siehe Hinweise.

Das Window-Steuerelement enthält stets ein primäres Fensterelement, das sich auf den Bezeichner bezieht, den der Benutzer als bedeutungsvollsten Bezeichner für das Element assoziieren würde.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle werden die UI Automation-Steuerelementmuster aufgelistet, die von allen Window-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster

Unterstützung

Hinweise

IDockProvider

Bedingt

Muss unterstützt werden, wenn das Fenster die Fähigkeit hat, angedockt zu werden.

ITransformProvider

Erforderlich

Ermöglicht es, das Fenster auf dem Bildschirm zu verschieben, zu drehen oder seine Größe zu ändern.

IWindowProvider

Erforderlich

Aktiviert bestimmte Vorgänge für das Fenster.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle sind die UI Automation-Ereignisse aufgelistet, die von allen Window-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI Automation-Ereignis

Unterstützung

Hinweise

AsyncContentLoadedEvent

Erforderlich

Keine

AutomationFocusChangedEvent

Erforderlich

Keine

Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

LayoutInvalidatedEvent

Erforderlich

Keine

Durch geänderte NameProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Durch geänderte HorizontallyScrollableProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

Durch geänderte HorizontalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

Durch geänderte HorizontalViewSizeProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

Durch geänderte VerticalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

Durch geänderte VerticallyScrollableProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

Durch geänderte VerticalViewSizeProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

WindowClosedEvent

Erforderlich

Keine

WindowOpenedEvent

Erforderlich

Keine

Durch geänderte WindowVisualStateProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

Siehe auch

Referenz

Window

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung