Steuerelementtyp der Registerkarte

  • Artikel

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

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 Tab-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Registerkartensteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Benutzeroberflächenplattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur der Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Registerkartensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

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 sind (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)
    • 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 besonders für Registerkartensteuerelemente relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Hinweise
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht 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 anklickbare Punkte.
UIA_ControlTypePropertyId Registerkarte
UIA_IsContentElementPropertyId TRUE Das Registerkartensteuerelement ist immer in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung enthalten.
UIA_IsControlElementPropertyId TRUE Das Registerkartensteuerelement ist immer in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung 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 Tab-Steuerelementtyp 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 Steuerelementmuster der Benutzeroberflächenautomatisierung 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 Hinweise
ISelectionProvider Erforderlich Alle Registerkartensteuerelemente müssen das Auswahl-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 Scroll-Steuerelementmuster muss unterstützt werden, wenn das Registerkartensteuerelement Über Widgets verfügt, durch die eine Reihe von Registerkartenelementen gescrollt werden kann.

 

Erforderliche Ereignisse

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

Ereignis der Benutzeroberflächenautomatisierung Hinweise
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis.
UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontallyScrollablePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalScrollPercentPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalViewSizePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticallyScrollablePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalScrollPercentPropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalViewSizePropertyId Eigenschaft geändertes Ereignis. Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_StructureChangedEventId

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung