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
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
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 |
|---|---|
|
|
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. |
Zugehörige Themen