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

Aktualisiert: November 2007

Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den Window-Steuerelementtyp. Bei der UI-Automatisierung 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-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte und Steuerelementmuster ein.

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

Die UI-Automatisierung-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-Automatisierung-Struktur für Window-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI-Automatisierung-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-Automatisierung-Eigenschaften aufgelistet, deren Wert oder Definition für Window-Steuerelemente besonders relevant ist. Weitere Informationen über UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI-Automatisierung-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-Automatisierung-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/Mustereigenschaft

Unterstützung/Wert

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-Automatisierung-Ereignisse aufgelistet, die von allen Window-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI-Automatisierung-Ereignis

Unterstützung

Hinweise

AsyncContentLoadedEvent

Erforderlich

Keine

AutomationFocusChangedEvent

Erforderlich

Keine

Durch geänderte Eigenschaft ausgelöstes BoundingRectangleProperty-Ereignis.

Erforderlich

Keine

Durch geänderte Eigenschaft ausgelöstes IsEnabledProperty-Ereignis.

Erforderlich

Keine

Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis.

Erforderlich

Keine

LayoutInvalidatedEvent

Erforderlich

Keine

Durch geänderte Eigenschaft ausgelöstes NameProperty-Ereignis.

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Durch geänderte Eigenschaft ausgelöstes HorizontallyScrollableProperty-Ereignis.

Variabel

Keine

Durch geänderte Eigenschaft ausgelöstes HorizontalScrollPercentProperty-Ereignis.

Variabel

Keine

Durch geänderte Eigenschaft ausgelöstes HorizontalViewSizeProperty-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 Eigenschaft ausgelöstes VerticalViewSizeProperty-Ereignis.

Variabel

Keine

WindowClosedEvent

Erforderlich

Keine

WindowOpenedEvent

Erforderlich

Keine

Durch geänderte Eigenschaft ausgelöstes WindowVisualStateProperty-Ereignis.

Variabel

Keine

Siehe auch

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung

Referenz

Window