Bereichssteuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den steuerelementtyp Bereich.
Der Bereichs- Steuerelementtyp ist für potenziell bildlauffähige Bereiche vorgesehen, die unterschiedlichen Inhalt aufweisen. 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 unter Fenstern oder Dokumenten dar, aber über einzelnen Steuerelementen. Der Benutzer navigiert zwischen Bereichen, indem er je nach Kontext TAB, F6 oder STRG+TAB drückt.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Bereich Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Bereichssteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Unterstützung der Benutzeroberflächenautomatisierung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält die folgenden Abschnitte.
- typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Bereich-Steuerelementtyp
- Verwandte Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Bereichssteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.
| 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 Präsentation verwendet wird.
Relevante Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für Bereichssteuerelemente relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| 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 zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein. |
| UIA_BoundingRectanglePropertyId | Siehe Hinweise. | Das äußerste Rechteck, das das gesamte Steuerelement enthält. |
| UIA_ClickablePointPropertyId | Siehe Hinweise. | Diese Eigenschaft macht einen klickbaren Punkt des Bereichssteuerelements verfügbar, der bewirkt, dass der Bereich fokussiert wird, wenn darauf 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 nicht vom Wert der UIA_NamePropertyId-Eigenschaft eindeutig ist. |
| UIA_IsContentElementPropertyId | STIMMT | Das Bereichssteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| UIA_IsControlElementPropertyId | STIMMT | Das Bereichssteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| UIA_IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| UIA_LabeledByPropertyId | Siehe Hinweise. | Bereichssteuerelemente verfügen in der Regel nicht über eine statische Beschriftung. Wenn eine statische Textbeschriftung vorhanden ist, sollte sie über diese Eigenschaft verfügbar gemacht werden. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem Steuerelementtyp Bereich entspricht. Der Standardwert ist "pane" für en-US oder Englisch (USA). |
| UIA_NamePropertyId | Siehe Hinweise. | Der Wert für diese Eigenschaft muss immer ein klarer, präziser und aussagekräftiger Titel sein. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von Bereichssteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.
| Steuerelementmuster | Unterstützen | Notizen |
|---|---|---|
| IDockProvider- | Hängt | Implementieren Sie das Dock- Steuerelementmuster, wenn das Bereichssteuerelement angedockt werden kann. |
| IScrollProvider- | Hängt | Implementieren Sie das Scroll- Steuerelementmuster, wenn das Bereichssteuerelement gescrollt werden kann. |
| ITransformProvider- | Hängt | Implementieren Sie das Transformieren Steuerelementmuster, wenn das Bereichssteuerelement auf dem Bildschirm verschoben, verkleinert oder gedreht werden kann. |
| IWindowProvider- | Nie | Wenn das Element das Window Steuerelementmuster implementieren muss, sollte das Steuerelement auf dem steuerelementtyp Window basieren. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die Bereichssteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.
| Benutzeroberflächenautomatisierungs-Ereignis | Notizen |
|---|---|
| UIA_AsyncContentLoadedEventId | |
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis. | |
| UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. | Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollHorizontallyScrollablePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollHorizontalScrollPercentPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollHorizontalViewSizePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollVerticallyScrollablePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollVerticalScrollPercentPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollVerticalViewSizePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_StructureChangedEventId |
Pane-Steuerelementtyp (Beispiel)
Die folgende Abbildung zeigt ein Steuerelement, das den steuerelementtyp Pane implementiert.
| Benutzeroberflächenautomatisierungsstruktur – Steuerelementansicht | Benutzeroberflächenautomatisierungsstruktur – Inhaltsansicht |
|---|---|
|
|
Verwandte Themen
-
Konzeptionelle
-
Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung