Implementieren des Scroll-Steuerelementmusters der Benutzeroberflächenautomatisierung

Hinweis

Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.

Dieses Thema enthält Richtlinien und Konventionen für das Implementieren von IScrollProvider, einschließlich Informationen über Ereignisse und Eigenschaften. Links zu zusätzlichen Referenzen sind am Ende dieses Themas aufgelistet.

Das ScrollPattern -Steuerelementmuster dient zur Unterstützung eines Steuerelements, das als bildlauffähiger Container für eine Auflistung von untergeordneten Objekten fungiert. Es ist nicht erforderlich, dass das Steuerelement Bildlaufleisten verwendet, um die Bildlauffunktionen zu unterstützen, obwohl dies häufig der Fall ist.

Beispiel für ein Scrollsteuerelement, das keine Scrollleisten verwendet

Beispiele für Steuerelemente, die dieses Steuerelement implementieren, finden Sie unter Control Pattern Mapping for UI Automation Clients.

Implementierungsrichtlinien und -konventionen

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

• Die untergeordneten Elemente dieses Steuerelements müssen IScrollItemProviderimplementieren.

• Die Bildlaufleisten eines Containersteuerelements bieten keine Unterstützung für das ScrollPattern -Steuerelementmuster. Sie müssen stattdessen die RangeValuePattern -Steuerelementmuster unterstützen.

• Wenn das Scrollen in Prozentwerten gemessen wird, müssen alle Werte oder Beträge, die sich auf die Einteilung der Bildlaufleiste beziehen, auf einen Bereich von 0 bis 100 normalisiert werden.

• HorizontallyScrollableProperty und VerticallyScrollableProperty sind unabhängig von der IsEnabledProperty.

• Wenn HorizontallyScrollableProperty = false ist, dann muss HorizontalViewSizeProperty auf 100 % und HorizontalScrollPercentProperty auf NoScroll. Wenn VerticallyScrollableProperty = false ist, dann muss VerticalViewSizeProperty ebenso auf 100 % und VerticalScrollPercentProperty auf NoScroll. Dadurch kann ein Benutzeroberflächenautomatisierungs-Client diese Eigenschaftswerte innerhalb der SetScrollPercent -Methode verwenden, während zugleich eine Racebedingung vermieden wird, wenn eine Richtung aktiviert wird, die für den Client für einen Bildlauf nicht von Interesse ist.

• HorizontalScrollPercent ist gebietsschemaspezifisch. Bei der Einstellung „HorizontalScrollPercent = 100,0“ muss die Bildlaufposition des Steuerelements auf das Äquivalent seiner äußersten rechten Position für Sprachen wie Englisch festgelegt werden, die von links nach rechts gelesen werden. Für Sprachen wie Arabisch, die von rechts nach links gelesen werden, muss die Bildlaufposition bei der Einstellung „HorizontalScrollPercent = 100,0“ auf der äußerste linke Position festgelegt werden.

Erforderliche Member für IScrollProvider

Die folgenden Eigenschaften und Methoden sind für das Implementieren von IScrollProvidererforderlich.

Erforderlicher Member	Memberart	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

Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp	Bedingung
ArgumentException	Scroll löst diese Ausnahme aus, wenn ein Steuerelement SmallIncrement -Werte ausschließlich für horizontale oder vertikale Bildläufe unterstützt, aber ein LargeIncrement -Wert übergeben wird.
ArgumentException	SetScrollPercent löst diese Ausnahme aus, wenn ein Wert, der nicht in einen Double-Wert konvertiert werden kann, übergeben wird.
ArgumentOutOfRangeException	SetScrollPercent löst diese Ausnahme aus, wenn ein Wert größer 100 oder kleiner 0 übergeben wird (außer bei -1, was NoScrollentspricht).
InvalidOperationException	Sowohl Scroll als auch SetScrollPercent lösen diese Ausnahme aus, wenn versucht wird, in eine nicht unterstützte Richtung zu scrollen.

Weitere Informationen

• Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung
• Unterstützung von Steuerelementmustern in einem Benutzeroberflächenautomatisierungs-Anbieter
• Steuerelementmuster für Benutzeroberflächenautomatisierung für Clients
• Übersicht über die Benutzeroberflächenautomatisierungs-Struktur
• Verwenden der Zwischenspeicherung in der Benutzeroberflächenautomatisierung