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

Aktualisiert: November 2007

Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den ScrollBar-Steuerelementtyp. In der UI-Automatisierung besteht ein Steuerelementtyp aus einer Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte und Steuerelementmuster ein.

Mit ScrollBar-Steuerelementen können Sie einen Bildlauf für den Inhalt eines Fenster- oder Elementcontainers ausführen. Das Steuerelement besteht aus einer Gruppe von Schaltflächen und einem Thumb-Steuerelement.

In den folgenden Abschnitten werden die UI-Automatisierung-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den ScrollBar-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-Anforderungen gelten für alle Listensteuerelemente, 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 Steuerelementmuster der Benutzeroberflächenautomatisierung
  • Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
  • Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI-Automatisierung-Struktur, die sich auf ScrollBar-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

  • ScrollBar

    • Schaltflächen (2 oder 4)

    • Ziehpunkt (0 oder1)

Das ScrollBar-Steuerelement enthält keinen Inhalt.

Das ScrollBar-Steuerelement umfasst immer drei bis fünf untergeordnete Elemente. Da die Teilstruktur mehrere Schaltflächen enthält, müssen Sie einen bestimmten AutomationIdProperty-Wert für jedes Element festlegen, sodass diese von Testautomatisierungstools erkannt werden können.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle sind die UI-Automatisierung-Eigenschaften aufgelistet, deren Werte oder Definitionen für die ScrollBar-Steuerelemente besonders wichtig sind. Beachten Sie, dass ein ScrollBar-Steuerelement keinen Inhalt enthält. Seine Funktionalität wird über das von dem Container unterstützte Bildlauf-Steuerelementmuster verfügbar gemacht, für den der Bildlauf ausgeführt wird.

Weitere Informationen über die UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI-Automatisierung-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, das gesamte Steuerelement umfassende Rechteck.

IsKeyboardFocusableProperty

Siehe Hinweise.

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

NameProperty

Null

Das ScrollBar-Steuerelement enthält keine Inhaltselemente, und die NameProperty muss nicht festgelegt werden.

ClickablePointProperty

Keine Zahl.

Das ScrollBar-Steuerelement enthält keine durch Klicken aktivierbaren Punkte.

LabeledByProperty

Null

Die Bildlaufleisten enthalten keine Bezeichnungen.

ControlTypeProperty

ScrollBar

Dieser Wert ist für alle Frameworks gleich. Von Bildlaufleisten, die wie Schieberegler funktionieren, muss der Slider-Steuerelementtyp verwendet werden.

LocalizedControlTypeProperty

"Bildlaufleiste"

Lokalisierte Zeichenfolge, die dem Button-Steuerelementtyp entspricht.

IsContentElementProperty

False

Das ScrollBar-Steuerelement ist nie ein Inhaltselement. Wenn es sich um ein eigenständiges ScrollBar-Steuerelement handelt, muss es dem Slider-Steuerelementtyp entsprechen und ControlType.Slider für die ControlType-Eigenschaft zurückgeben.

IsControlElementProperty

True

Die Bildlaufleiste muss immer ein Steuerelement sein.

OrientationProperty

True

Die horizontale oder vertikale Ausrichtung muss vom ScrollBar-Steuerelement immer verfügbar gemacht werden.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle werden die UI-Automatisierung-Steuerelementmuster aufgelistet, die von ScrollBar-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung. Beachten Sie, dass Steuerelementmuster nicht unterstützt werden, wenn eine Bildlaufleiste nur über eine Maus als Steuerelement verwendet wird. Wenn es in einer Anwendung als Slider-Steuerelement verwendet wird, muss ihm der Slider-Steuerelementtyp zugewiesen werden.

Steuerelementmuster/Mustereigenschaft

Unterstützung/Wert

Hinweise

IScrollProvider

Nie

Das Scroll-Steuerelementmuster wird auf der Bildlaufleiste nie direkt unterstützt.

IRangeValueProvider

Variabel

Diese Funktionalität muss nur unterstützt werden, wenn das Scroll-Steuerelementmuster von dem die Bildlaufleiste enthaltenden Container nicht unterstützt wird.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

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

UI-Automatisierung-Ereignis

Unterstützung/Wert

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.

Nie

Keine

Durch geänderte HorizontalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis.

Nie

Keine

Durch geänderte HorizontalViewSizeProperty-Eigenschaft ausgelöstes Ereignis.

Nie

Keine

Durch geänderte VerticalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis.

Nie

Keine

Durch geänderte VerticallyScrollableProperty-Eigenschaft ausgelöstes Ereignis.

Nie

Keine

Durch geänderte VerticalViewSizeProperty-Eigenschaft ausgelöstes Ereignis.

Nie

Keine

Durch geänderte ValueProperty-Eigenschaft ausgelöstes Ereignis.

Variabel

Keine

AutomationFocusChangedEvent

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Siehe auch

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung

Referenz

ScrollBar