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

Hinweis
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 ScrollBar-Steuerelementtyp. In der UI Automation 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 Automation-Struktur, UI Automation-Eigenschaftswerte 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 Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den ScrollBar-Steuerelementtyp erforderlich sind. Die UI Automation-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 Automation-Struktur, die sich auf ScrollBar-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht	Inhaltsansicht
ScrollBar Button (2 oder 4) Ziehpunkt (0 oder1)	Nicht zutreffend. 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 Automation-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 UI Automation-Eigenschaften 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	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 Automation--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	Unterstützung	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 Automation-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 Automation-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

Referenz

ScrollBar

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung