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

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
  • Bereich
  • Bereich

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.

Benutzeroberflächenautomatisierung-Ereignis Notizen
UIA _ AsyncContentLoadedEventId
UIA _ AutomationFocusChangedEventId
UIA _ BoundingRectanglePropertyId-Eigenschaftsänderungsereignis.
UIA _ IsOffscreenPropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA _ ScrollHorizontallyScrollablePropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement das Bildlauf-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ ScrollHorizontalScrollPercentPropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement das Bildlauf-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ ScrollHorizontalViewSizePropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement das Bildlauf-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ ScrollVerticallyScrollablePropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement das Bildlauf-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ ScrollVerticalScrollPercentPropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement das Bildlauf-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ ScrollVerticalViewSizePropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement das Bildlauf-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 Bereich implementiert.

Screenshot, der ein Beispiel für ein Bereichssteuerfeld zeigt

Benutzeroberflächenautomatisierung Struktur – Steuerelementansicht Benutzeroberflächenautomatisierung Struktur – Inhaltsansicht
  • Bereich
    • Struktur (Scroll-Muster)
      • TreeItem
      • ...
  • Bereich
    • Bearbeiten (Bildlaufmuster)
  • Bereich
    • Struktur (Scroll-Muster)
      • TreeItem
      • ...
    • Bereich
      • Bearbeiten (Bildlaufmuster)

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung