Bereichssteuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung des Steuerelementtyps Bereich Benutzeroberflächenautomatisierung von Microsoft.
Der Bereich-Steuerelementtyp ist für potenziell scrollbare Regionen mit unterschiedlichem Inhalt vorgesehen. Es wird verwendet, um ein Objekt innerhalb eines Rahmens oder Dokumentfensters darzustellen. Benutzer können zwischen Bereichssteuerelementen und innerhalb des Inhalts des aktuellen Bereichs navigieren. Bereichssteuerelemente stellen eine Ebene der Gruppierung dar, die niedriger ist als Fenster oder Dokumente, aber über einzelnen Steuerelementen. Der Benutzer kann je nach Kontext durch Drücken von TAB, F6 oder STRG+TAB zwischen den Bereichen navigieren.
In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp Pane definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Bereichssteuerelemente, in denen das Benutzeroberflächenframework bzw. die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert ist.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Beispiel für Pane-Steuerelementtyp
- Zugehörige Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Bereichssteuerelemente 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 |
|---|---|
|
|
Ein Bereichssteuerelement wird immer in den Steuerelement- und Inhaltsansichten angezeigt. Machen Sie ein Layoutobjekt nicht als Bereich in der Steuerelement- oder Inhaltsansicht verfügbar, wenn das Objekt nur für die visuelle Darstellung verwendet wird.
Relevante Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition für Bereichssteuerelemente besonders relevant sind. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| UIA_AccessKeyPropertyId | Siehe Hinweise. | Wenn eine bestimmte Tastenkombination den Fokus auf den Bereich legt, sollten diese Informationen über diese Eigenschaft verfügbar gemacht werden. |
| 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. | Diese Eigenschaft macht einen durch Klicken aktivierbaren Punkt des Bereichssteuerelements verfügbar, durch den der Bereich den Fokus erhält, wenn auf den Punkt geklickt wird. |
| UIA_ControlTypePropertyId | Bereich | |
| UIA_HelpTextPropertyId | Siehe Hinweise. | Der Hilfetext für Bereichssteuerelemente sollte den Zweck des Frames und seine Beziehung zu anderen Frames erläutern. Eine Beschreibung ist erforderlich, wenn der Zweck und die Beziehung der Frames aus dem Wert der UIA_NamePropertyId-Eigenschaft nicht eindeutig sind. |
| UIA_IsContentElementPropertyId | TRUE | Das Bereichssteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
| UIA_IsControlElementPropertyId | TRUE | Das Bereichssteuerelement 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 | Siehe Hinweise. | Bereichssteuerelemente haben in der Regel keine statische Bezeichnung. Ist eine statische Beschriftung vorhanden, muss sie über diese Eigenschaft verfügbar gemacht werden. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem Steuerelementtyp Bereich entspricht. Der Standardwert ist "Bereich" für en-US oder Englisch (USA). |
| UIA_NamePropertyId | Siehe Hinweise. | Der Wert für diese Eigenschaft muss immer ein eindeutiger, präziser und aussagekräftiger Titel sein. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von Bereichssteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster | Support | Hinweise |
|---|---|---|
| IDockProvider | Depends (Abhängig) | Implementieren Sie das Dock-Steuerelementmuster, wenn das Bereichssteuerelement angedockt werden kann. |
| IScrollProvider | Depends (Abhängig) | Implementieren Sie das Scroll-Steuerelementmuster, wenn das Bereichssteuerelement scrollen kann. |
| ITransformProvider | Depends (Abhängig) | Implementieren Sie das Transformationssteuerelementmuster, wenn das Bereichssteuerelement auf dem Bildschirm verschoben, die Größe geändert oder gedreht werden kann. |
| IWindowProvider | Nie | Wenn das Element das Window-Steuerelementmuster implementieren muss, sollte das Steuerelement auf dem Window-Steuerelementtyp basieren. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Bereichssteuerelemente 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_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| 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 |
Beispiel für Pane-Steuerelementtyp
Die folgende Abbildung veranschaulicht ein Steuerelement, das den Steuerelementtyp Pane implementiert.
| Benutzeroberflächenautomatisierung Struktur – Steuerungsansicht | Benutzeroberflächenautomatisierung Struktur – Inhaltsansicht |
|---|---|
|
|
Zugehörige Themen