Bereichssteuerungstyp
Dieses Thema enthält Informationen zu Microsoft Benutzeroberflächenautomatisierung-Unterstützung für den Steuerelementtyp Bereich.
Der Steuerelementtyp Bereich ist für potenziell bildlauffähige Bereiche mit unterschiedlichen Inhalten. Es wird verwendet, um ein Objekt innerhalb eines Rahmens oder Dokumentfensters zu darstellen. Benutzer können zwischen Bereichssteuerelementen und innerhalb des Inhalts des aktuellen Bereichs navigieren. Bereichssteuerelemente stellen eine Gruppierungsebene dar, die niedriger als Fenster oder Dokumente, aber über einzelnen Steuerelementen ist. 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 Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp Bereich definiert. Die Benutzeroberflächenautomatisierung gelten für alle Bereichssteuerelemente, 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
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Beispiel für Pane-Steuerelementtyp
- Zugehörige Themen
Typische Strukturstruktur
Die folgende Tabelle zeigt ein typisches Steuerelement und eine Inhaltsansicht der Benutzeroberflächenautomatisierung struktur, die sich auf Bereichssteuerelemente 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 |
|---|---|
|
|
Ein Bereichssteuerfeld wird immer in den Steuerelement- und Inhaltsansichten angezeigt. Machen Sie ein Layoutobjekt weder im Steuerelement noch in der Inhaltsansicht als Bereich verfügbar, wenn das Objekt nur für die visuelle Darstellung verwendet wird.
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung, deren Wert oder Definition für Bereichssteuerelemente 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 _ AccessKeyPropertyId | Siehe Hinweise. | Wenn eine bestimmte Tastenkombination den Fokus auf den Bereich erhält, 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 rohen Ansicht der Benutzeroberflächenautomatisierung 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 Zusammenhang mit anderen Frames erläutern. Eine Beschreibung ist erforderlich, wenn der Zweck und die Beziehung der Frames aus dem Wert der _ UIA-Eigenschaft NamePropertyId nicht eindeutig sind. |
| UIA _ IsContentElementPropertyId | TRUE | Das Bereichssteuerfeld ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung enthalten. |
| UIA _ IsControlElementPropertyId | TRUE | Das Bereichssteuerfeld 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 | 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 "pane" für en-US oder English (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, die von Bereichssteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster | Support | Notizen |
|---|---|---|
| IDockProvider | Depends (Abhängig) | Implementieren Sie das Dock-Steuerelementmuster, wenn das Bereichssteuerfeld angedockt werden kann. |
| IScrollProvider | Depends (Abhängig) | Implementieren Sie das Bildlauf-Steuerelementmuster, wenn für das Bereichssteuerfeld ein Bildlauf möglich ist. |
| ITransformProvider | Depends (Abhängig) | Implementieren Sie das Steuerelementmuster Transformieren, wenn das Bereichssteuerfeld auf dem Bildschirm verschoben, seine Größe geändert 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ächenautomatisierung, die Bereichssteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
Beispiel für Pane-Steuerelementtyp
Die folgende Abbildung veranschaulicht ein Steuerelement, das den Steuerelementtyp Bereich implementiert.

| Benutzeroberflächenautomatisierung Struktur – Steuerelementansicht | Benutzeroberflächenautomatisierung Struktur – Inhaltsansicht |
|---|---|
|
|