Implementieren des Scroll-Steuerelementmusters der Benutzeroberflächenautomatisierung

Artikel
08/10/2011

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.

In diesem Thema werden Richtlinien und Konventionen zum Implementieren von IScrollProvider vorgestellt sowie Ereignisse und Eigenschaften erläutert. Am Ende des Themas finden Sie Links zu zusätzlichen Verweisen.

Das ScrollPattern-Steuerelementmuster dient als Unterstützung für Steuerelemente, die als Container mit Bildlauffunktionalität für eine Auflistung von untergeordneten Objekten verwendet werden. Vom Steuerelement wird in der Regel eine Bildlaufleiste verwendet, um die Bildlauffunktionalität zu unterstützen, dies ist jedoch nicht unbedingt erforderlich.

Beispiel für ein Steuerelement mit Bildlauffunktionalität, von dem keine Bildlaufleisten verwendet wird

Bildlauf für Steuerelemente ohne Schiebeleisten durchführen

Beispiele für Steuerelemente, von denen dieses Steuerelement implementiert wird, finden Sie unter Zuordnen von Steuerelementmustern für Benutzeroberflächenautomatisierungs-Clients.

Dieses Thema enthält folgende Abschnitte.

Implementierungsrichtlinien und Konventionen
Erforderliche Member für IScrollProvider
Ausnahmen
Verwandte Abschnitte

Implementierungsrichtlinien und Konventionen

Beachten Sie beim Implementieren des Scroll-Steuerelementmusters die folgenden Richtlinien und Konventionen:

Von den untergeordneten Elementen dieses Steuerelements muss IScrollItemProvider implementiert werden.
Von den Bildlaufleisten eines Containersteuerelements wird das ScrollPattern-Steuerelementmuster nicht unterstützt. Sie müssen stattdessen das RangeValuePattern-Steuerelementmuster unterstützen.
Wenn der Bildlauf in Prozent gemessen wird, müssen alle Werte oder Mengen, die sich auf den Bildlauf beziehen, auf einen Bereich von 0 bis 100 normalisiert werden.
HorizontallyScrollableProperty und VerticallyScrollableProperty sind unabhängig vom IsEnabledProperty.
Wenn HorizontallyScrollableProperty = false ist, sollte die HorizontalViewSizeProperty auf 100% und die HorizontalScrollPercentProperty auf NoScroll festgelegt werden. Wenn VerticallyScrollableProperty = false ist, sollte die VerticalViewSizeProperty entsprechend auf 100 Prozent und VerticalScrollPercentProperty auf NoScroll festgelegt werden. Von einem Benutzeroberflächenautomatisierungs-Client können diese Eigenschaftswerte hierdurch in einer SetScrollPercent-Methode verwendet und eine Racebedingung vermieden werden, wenn eine vom Client nicht gewünschte Bildlaufrichtung aktiviert wird.
HorizontalScrollPercent ist gebietsschemaspezifisch. Bei der Einstellung HorizontalScrollPercent = 100,0 muss der Bildlauf des Steuerelements für Sprachen, die von links nach rechts gelesen werden, wie z. B. Englisch, auf die sich am weitesten rechts befindliche Position festgelegt werden. Für Sprachen wie Arabisch, die von rechts nach links gelesen werden, muss bei der Einstellung HorizontalScrollPercent = 100,0 der Bildlauf hingegen auf die sich am weitesten links befindliche Position festgelegt werden.

Erforderliche Member für IScrollProvider

Zum Implementieren von IScrollProvider werden die folgenden Eigenschaften und Methoden benötigt.

Erforderliche Member	Membertyp	Hinweise
HorizontalScrollPercent	Eigenschaft	Keine
VerticalScrollPercent	Eigenschaft	Keine
HorizontalViewSize	Eigenschaft	Keine
VerticalViewSize	Eigenschaft	Keine
HorizontallyScrollable	Eigenschaft	Keine
VerticallyScrollable	Eigenschaft	Keine
Scroll	Methode	Keine
SetScrollPercent	Methode	Keine

Dieses Steuerelementmuster verfügt über keine zugeordneten Ereignisse.

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp	Bedingung
ArgumentException	Von Scroll wird diese Ausnahme ausgelöst, wenn von einem Steuerelement SmallIncrement-Werte nur für den horizontalen oder vertikalen Bildlauf unterstützt werden, jedoch ein LargeIncrement-Wert übergeben wird.
ArgumentException	SetScrollPercent löst diese Ausnahme aus, wenn ein Wert übergeben wird, der nicht in einen Double-Wert konvertiert werden kann.
ArgumentOutOfRangeException	Von SetScrollPercent wird diese Ausnahme ausgelöst, wenn ein Wert größer 100 oder kleiner 0 übergeben wird (außer -1, dieser Wert entspricht NoScroll).
InvalidOperationException	Sowohl von Scroll als auch von SetScrollPercent wird diese Ausnahme ausgelöst, wenn versucht wird, den Bildlauf in einer nicht unterstützten Richtung auszuführen.