Freigeben über


Fenstersteuerelementtyp

Dieses Thema enthält Informationen zur Unterstützung des Window-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.

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

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Window-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Fenstersteuerelemente, in denen das Ui-Framework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Fenstersteuerelemente bezieht, und beschreibt, was in den einzelnen Ansichten enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

Steuerelementansicht Inhaltsansicht
  • Fenster
  • Fenster

 

Relevante Eigenschaften

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

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Hinweise
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht der Benutzeroberflächenautomatisierung Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Das Fenstersteuerelement muss über einen klickbaren Punkt verfügen, der dazu führt, 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 Fenstersteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA_IsControlElementPropertyId TRUE Das Fenstersteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur 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 Window-Steuerelementtyp entspricht. Der Standardwert ist "Window" für en-US oder English (USA).
UIA_NamePropertyId Siehe Hinweise. Das Fenstersteuerelement enthält immer ein primäres Fensterelement, das sich darauf bezieht, was der Benutzer als semantischen Bezeichner für das Element zuordnen würde.

 

Erforderliche Steuerelementmuster

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

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

 

Erforderliche Ereignisse

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

Ereignis der Benutzeroberflächenautomatisierung Hinweise
UIA_AsyncContentLoadedEventId
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis.
UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_LayoutInvalidatedEventId
UIA_NamePropertyId Eigenschaft geändertes Ereignis.
UIA_ScrollHorizontallyScrollablePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalScrollPercentPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalViewSizePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticallyScrollablePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalScrollPercentPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalViewSizePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_StructureChangedEventId
UIA_Window_WindowClosedEventId
UIA_Window_WindowOpenedEventId
UIA_WindowWindowVisualStatePropertyId Eigenschaft geändertes Ereignis. 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