Freigeben über


Benutzeroberflächenautomatisierungs-Unterstützung für den Tab-Steuerelementtyp

HinweisHinweis

Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

Dieses Thema enthält Informationen über die UI Automation-Unterstützung für den Tab-Steuerelementtyp. In UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen enthalten bestimmte Richtlinien für die UI Automation-Struktur, UI Automation-Eigenschaftswerte und UI Automation-Steuerelementmuster.

Ein Tab-Steuerelement entspricht in etwas den Trennblättern in einem Ordner oder den Schildern in einer Hängeregistratur. Durch ein Tab-Steuerelement können durch eine Anwendung mehrere Seiten für denselben Bereich in einem Fenster oder Dialogfeld definiert werden.

In den folgenden Abschnitten werden die UI Automation-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse definiert, die für den Tab-Steuerelementtyp erforderlich sind.. Die UI Automation-Anforderungen gelten für alle Tab-Steuerelemente, seien dies Windows Presentation Foundation (WPF)-, Win32- oder Windows Forms-Steuerelemente.

Dieses Thema enthält folgende Abschnitte.

  • Erforderliche Benutzeroberflächenautomatisierungs-Struktur
  • Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
  • Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und Eigenschaften
  • Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
  • Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur für Tab-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

Registerkarte

  • TabItem (1 oder mehr)

  • ScrollBar (0 oder 1)

    • Button (0 oder 2)

Registerkarte

  • TabItem (1 oder mehr)

Tab-Steuerelemente verfügen über untergeordnete UI Automation-Elemente, die auf dem TabItem-Steuerelementtyp basieren. Wenn Registerkartenelemente (z. B. wie in Microsoft Office 2007-Anwendungen) gruppiert werden, kann der Tab-Steuerelementtyp auch Groups-Steuerelementtypen für die gruppierten Registerkartenelemente hosten, wie die folgende Struktur zeigt.

Steuerelementansicht

Inhaltsansicht

Registerkarte

  • TabItem (1 oder mehr)

  • Group (beliebige Anzahl)

    • TabItem (0 oder mehr)

  • ScrollBar (beliebige Anzahl)

    • Button (0 oder 2)

Registerkarte

  • TabItem (1 oder mehr)

  • Group (beliebige Anzahl)

    • TabItem (0 oder mehr)

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Wert oder Definition für den Tab-Steuerelementtyp besonders relevant ist. Weitere Informationen zu UI Automationseigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-Eigenschaft

Wert

Hinweise

AutomationIdProperty

Siehe Hinweise.

Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.

BoundingRectangleProperty

Siehe Hinweise.

Das äußere Rechteck, welches das gesamte Steuerelement umfasst.

IsKeyboardFocusableProperty

Siehe Hinweise.

Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.

NameProperty

Siehe Hinweise.

Das Tab-Steuerelement erfordert selten eine Namen-Eigenschaft.

ClickablePointProperty

Nein

Das Tab-Steuerelement verfügt über keinen Punkt, der durch Klicken aktiviert werden kann.

LabeledByProperty

Siehe Hinweise.

Tab-Steuerelemente verfügen i. d. R. über eine statische Beschriftung, die durch diese Eigenschaft verfügbar gemacht wird.

ControlTypeProperty

Registerkarte

Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.

LocalizedControlTypeProperty

"Registerkarte"

Lokalisierte Zeichenfolge für den Tab-Steuerelementtyp.

IsKeyboardFocusableProperty

True

Der Tab-Steuerelementtyp muss in der Lage sein, den Tastaturfokus zu empfangen. In der Regel ruft ein UI Automation-Client "SetFocus" auf einem Tab-Steuerelement auf. Durch eines der zugehörigen Elemente wird der Tastaturfokus an das Tab-Steuerelement weitergeleitet. Bei einigen Tab-Containern ist es möglich, einen Fokus zu haben, ohne dass der Fokus für eines der zugehörigen Elemente festgelegt werden muss.

IsContentElementProperty

True

Das Tab-Steuerelement ist stets in der Inhaltsansicht der UI Automation-Struktur enthalten.

IsControlElementProperty

True

Das Tab-Steuerelement ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten.

OrientationProperty

Siehe Hinweise.

Durch das Tab-Steuerelement muss immer angeben werden, ob es horizontal oder vertikal positioniert wird.

Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und Eigenschaften

In der folgenden Tabelle werden die UI Automation-Steuerelementmuster aufgelistet, die von allen Tab-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster/Mustereigenschaft

Unterstützung/Wert

Hinweise

ISelectionProvider

Ja

Alle Tab-Steuerelemente müssen das Auswahlmuster unterstützen.

IsSelectionRequired

True

Tab-Steuerelemente erfordern immer, dass eine Auswahl getroffen wird.

CanSelectMultiple

False

Tab-Steuerelemente sind immer Einzelauswahlcontainer.

IScrollProvider

Variabel

Das Bildlaufmuster muss unterstützt werden, wenn das Tab-Steuerelement über Widgets verfügt, die einen Bildlauf durch mehrere Registerkartenelemente ermöglichen.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle werden die UI Automation-Ereignisse aufgelistet, die von allen Tab-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI Automation-Ereignis

Unterstützung

Hinweise

Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte HorizontallyScrollableProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

Durch geänderte HorizontalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

Durch geänderte HorizontallyScrollableProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

Durch geänderte HorizontalViewSizeProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

Durch geänderte VerticalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

Durch geänderte VerticalViewSizeProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

AutomationFocusChangedEvent

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Siehe auch

Referenz

Tab

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung