Fenster-Steuerelementtyp

Dieses Thema enthält Informationen zu Microsoft Benutzeroberflächenautomatisierung-Unterstützung für den Fenster-Steuerelementtyp.

Das Window-Steuerelement besteht aus dem Fensterrahmen, der untergeordnete Objekte wie Titelleiste, Client sowie andere Objekte enthält.

In den folgenden Abschnitten werden die Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Fenster-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung gelten für alle Fenstersteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Strukturstruktur

Die folgende Tabelle zeigt ein typisches Steuerelement und eine Inhaltsansicht der Benutzeroberflächenautomatisierung, die sich auf Fenstersteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur Benutzeroberflächenautomatisierung Struktur finden Sie unter Benutzeroberflächenautomatisierung Strukturübersicht.

Steuerelementansicht Inhaltsansicht
  • Fenster
  • Fenster

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition für Fenstersteuerelemente besonders relevant ist. Weitere Informationen zu Eigenschaften Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA _ AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der rohen Ansicht der Benutzeroberflächenautomatisierung sein.
UIA _ BoundingRectanglePropertyId Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
UIA _ ClickablePointPropertyId Siehe Hinweise. Das Fenster-Steuerelement muss über einen klickbaren Punkt verfügen, der bewirkt, dass das Fenster ausgewählt oder deaktiviert wird.
UIA _ ControlTypePropertyId Fenster Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
UIA _ IsContentElementPropertyId TRUE Das Fenster-Steuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung enthalten.
UIA _ IsControlElementPropertyId TRUE Das Fenster-Steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung enthalten.
UIA _ IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA _ LabeledByPropertyId NULL Fenstersteuerelemente verfügen nicht über eine statische Fensterbezeichnung.
UIA _ LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem Steuerelementtyp Window entspricht. Der Standardwert ist "window" für en-US oder Englisch (USA).
UIA _ NamePropertyId Siehe Hinweise. Das Fenstersteuerelement enthält immer ein primäres Fensterelement, das sich darauf bezieht, was der Benutzer als semantischsten Bezeichner für das Element zuordnen würde.

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung, die von Fenstersteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster/Mustereigenschaft Unterstützung/Wert Notizen
IDockProvider Bedingt Das Dock-Steuerelementmuster muss unterstützt werden, wenn das Fenster angedockt werden kann.
ITransformProvider Erforderlich Mit dem Steuerelementmuster Transformieren kann das Fenster auf dem Bildschirm verschoben, seine Größe geändert oder gedreht werden. (Gilt nicht für Windows Store-Apps.)
IWindowProvider Erforderlich Das Fenster-Steuerelementmuster ermöglicht bestimmte Vorgänge für das Fenster.

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung aufgeführt, die von Window-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Benutzeroberflächenautomatisierung-Ereignis Notizen
UIA _ AsyncContentLoadedEventId
UIA _ AutomationFocusChangedEventId
UIA _ BoundingRectanglePropertyId-Eigenschaftsänderungsereignis.
UIA _ IsEnabledPropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA _ IsOffscreenPropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
_UIA-LayoutInvalidatedEventId
UIA _ Das NamePropertyId-Eigenschaftswechselereignis.
UIA _ ScrollHorizontallyScrollablePropertyId-Eigenschaftswechselereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ ScrollHorizontalScrollPercentPropertyId-Eigenschaftswechselereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ ScrollHorizontalViewSizePropertyId-Eigenschaftswechselereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ ScrollVerticallyScrollablePropertyId-Eigenschaftswechselereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ ScrollVerticalScrollPercentPropertyId-Eigenschaftswechselereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ ScrollVerticalViewSizePropertyId-Eigenschaftswechselereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ StructureChangedEventId
_ _ UIA-FensterFensterClosedEventId
_ _ UIA-FensterOpenedEventId
UIA _ WindowWindowVisualStatePropertyId-Eigenschaftswechselereignis. Wenn das Steuerelement die WindowVisualState-Eigenschaft des Window-Steuerelementmusters unterstützt, muss dieses Ereignis unterstützt werden.

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung