Freigeben über

Registerkartensteuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den Tab- Steuerelementtyp.

Ein Registerkartensteuerelement entspricht den Trennern in einem Notizbuch oder den Beschriftungen in einem Dateischrank. Mithilfe eines Registerkartensteuerelements kann eine Anwendung mehrere Seiten für denselben Bereich eines Fensters oder Dialogfelds definieren.

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Tab- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Registerkartensteuerelemente, 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 Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Registerkartensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • Registerkarte
    • TabItem (1 oder mehr)
    • ScrollBar (0 oder 1)
      • Schaltfläche (0 oder 2)
  • Registerkarte
    • TabItem (1 oder mehr)

 

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

Steuerelementansicht Inhaltsansicht
  • Registerkarte
    • TabItem (1 oder mehr)
    • Gruppe (0 oder mehr)
      • TabItem (0 oder mehr)
    • ScrollBar (0 oder 1)
      • Schaltfläche (0 oder 2)
  • Registerkarte
    • TabItem (1 oder mehr)
    • Gruppe (0 oder mehr)
      • TabItem (0 oder mehr)

 

Relevante Eigenschaften

In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für Registerkartensteuerelemente 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_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 Nein Das Registerkartensteuerelement verfügt nicht über klickbare Punkte.
UIA_ControlTypePropertyId Tab-
UIA_IsContentElementPropertyId STIMMT Das Registerkartensteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsControlElementPropertyId STIMMT Das Registerkartensteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsKeyboardFocusablePropertyId STIMMT Der Tabulator-Steuerelementtyp muss in der Lage sein, den Tastaturfokus zu erhalten. In der Regel ruft ein Benutzeroberflächenautomatisierungs-Client IUIAutomationElement::SetFocus auf einem Registerkartensteuerelement auf, und eines seiner Elemente leitet den Tastaturfokus an das Registerkartensteuerelement weiter. Es ist möglich, dass einige Registerkartencontainer den Fokus übernehmen können, ohne den Fokus auf eines seiner Elemente festzulegen.
UIA_LabeledByPropertyId Siehe Hinweise. Registerkartensteuerelemente verfügen in der Regel über eine statische Textbeschriftung, die über diese Eigenschaft verfügbar gemacht wird.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem Steuerelementtyp Tab 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. Das Registerkartensteuerelement muss immer angeben, ob es horizontal oder vertikal positioniert ist.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen Registerkartensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Control Pattern/Pattern-Eigenschaft Support/Wert Notizen
ISelectionProvider- Erforderlich Alle Registerkartensteuerelemente müssen das Auswahl- Steuerelementmuster unterstützen.
IsSelectionRequired- STIMMT Registerkartensteuerelemente erfordern immer, dass eine Auswahl getroffen wird.
CanSelectMultiple- FALSCH Registerkartensteuerelemente sind immer Einzelauswahlcontainer.
IScrollProvider- Hängt Das steuerelementmuster Bildlauf muss unterstützt werden, wenn das Registerkartensteuerelement Widgets enthält, die es ermöglichen, dass ein Satz von Registerkartenelementen durchsucht werden kann.

 

Erforderliche Ereignisse

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

Benutzeroberflächenautomatisierungs-Ereignis Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden.
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

 

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung