Registerkarten-Steuerelementtyp

Dieses Thema enthält Informationen zur Unterstützung von Microsoft Benutzeroberflächenautomatisierung für den Steuerelementtyp "Registerkarte".

Ein Registerkarten-Steuerelement entspricht in etwa einem Trennblatt in einem Notizbuch den Beschriftungen in einer Hängeregistratur. Durch Verwenden eines Registerkarten-Steuerelements können in einer Anwendung mehrere Seiten für denselben Bereich in einem Fenster oder Dialogfeld definiert werden.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Registerkarten-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Registerkartensteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur, die registerkartensteuerelemente betrifft, und beschreibt, was in den einzelnen Ansichten enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierung-Struktur finden Sie unter übersicht über Benutzeroberflächenautomatisierung-Struktur.

Steuerelementansicht Inhaltsansicht
  • Registerkarte
    • TabItem (1 oder mehr)
    • ScrollBar (0 oder 1)
      • Button (0 oder 2)
  • Registerkarte
    • TabItem (1 oder mehr)

Registerkartensteuerelemente verfügen über untergeordnete Benutzeroberflächenautomatisierung Elemente, die auf dem TabItem-Steuerelementtyp basieren. Wenn Registerkartenelemente gruppiert werden (z. B. wie in Microsoft Office Anwendungen), kann der Steuerelementtyp Tabstopp auch Gruppen-Steuerelementtypen für die gruppierten Registerkartenelemente hosten, wie die folgende Struktur zeigt.

Steuerelementansicht Inhaltsansicht
  • Registerkarte
    • TabItem (1 oder mehr)
    • Group (beliebige Anzahl)
      • TabItem (beliebige Anzahl)
    • ScrollBar (0 oder 1)
      • Button (0 oder 2)
  • Registerkarte
    • TabItem (1 oder mehr)
    • Group (beliebige Anzahl)
      • TabItem (beliebige Anzahl)

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für Registerkartensteuerelemente besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA _ AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der rohen Ansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein.
UIA _ BoundingRectanglePropertyId Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
UIA _ ClickablePointPropertyId Nein Das Registerkartensteuerelement verfügt nicht über klickbare Punkte.
UIA _ ControlTypePropertyId Registerkarte
UIA _ IsContentElementPropertyId TRUE Das Registerkartensteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA _ IsControlElementPropertyId TRUE Das Registerkartensteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA _ IsKeyboardFocusablePropertyId TRUE Der Tab-Steuerelementtyp muss den Tastaturfokus empfangen können. In der Regel ruft ein Benutzeroberflächenautomatisierung Client IUIAutomationElement::SetFocus auf einem Registerkartensteuerelement auf, und eines seiner Elemente leitet den Tastaturfokus an das Registerkartensteuerelement weiter. Bei einigen Registerkartencontainern ist es möglich, dass sie den Fokus annehmen, ohne dass der Fokus für eines ihrer Elemente festgelegt wurde.
UIA _ LabeledByPropertyId Siehe Hinweise. Registerkarten-Steuerelemente haben üblicherweise eine statische Beschriftung, die durch diese Eigenschaft verfügbar gemacht wird.
UIA _ LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem Steuerelementtyp Tabulator entspricht. Der Standardwert ist "tab" für en-US oder Englisch (USA).
_UIA-NamePropertyId Siehe Hinweise. Das Registerkartensteuerelement erfordert selten eine Name-Eigenschaft.
UIA _ OrientationPropertyId Siehe Hinweise. Durch das Registerkarten-Steuerelement muss immer angeben werden, ob es horizontal oder vertikal positioniert ist.

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von allen Registerkartensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster/Mustereigenschaft Unterstützung/Wert Notizen
ISelectionProvider Erforderlich Alle Registerkartensteuerelemente müssen das Selection-Steuerelementmuster unterstützen.
IsSelectionRequired TRUE Ein Registerkarten-Steuerelement erfordert immer, dass eine Auswahl getroffen wird.
CanSelectMultiple FALSE Registerkarten-Steuerelemente sind immer Einzelauswahlcontainer.
IScrollProvider Depends (Abhängig) Das Bildlauf-Steuerelementmuster muss unterstützt werden, wenn das Registerkarten-Steuerelement Widgets enthält, mit denen ein Satz von Registerkartenelementen durchscrollt werden kann.

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung, die Registerkartensteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Benutzeroberflächenautomatisierung-Ereignis Notizen
UIA _ AutomationFocusChangedEventId
UIA _ BoundingRectanglePropertyId-Eigenschaftsänderungsereignis.
UIA _ IsEnabledPropertyId-Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
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

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung