Bildlaufsteuerelementmuster

Beschreibt Richtlinien und Konventionen für die Implementierung von IScrollProvider, einschließlich Informationen zu Eigenschaften und Methoden. Das Scroll-Steuerelementmuster wird verwendet, um ein Steuerelement zu unterstützen, das als scrollbarer Container für eine Auflistung untergeordneter Objekte fungiert.

Das Steuerelement ist nicht erforderlich, um Bildlaufleisten zur Unterstützung der Scrollfunktion zu verwenden, obwohl dies in der Regel der Fall ist. Die folgende Abbildung zeigt ein Bildlaufsteuerelement, das keine Bildlaufleisten verwendet. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und ihre unterstützten Steuerelementmuster.

Dieses Thema enthält folgende Abschnitte:

• Implementierungsrichtlinien und -konventionen
• Erforderliche Member für IScrollProvider
• Zugehörige Themen

Implementierungsrichtlinien und -konventionen

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

• Die untergeordneten Elemente dieses Steuerelements müssen IScrollItemProvider implementieren.
• Die Bildlaufleisten eines Containersteuerelements unterstützen das Scroll-Steuerelementmuster nicht. Sie müssen stattdessen das RangeValue-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.
• Die Eigenschaft IScrollProvider::HorizontallyScrollable und VerticallyScrollable sind unabhängig von der IsEnabled-Eigenschaft .
• Wenn die IScrollProvider::HorizontallyScrollable-EigenschaftFALSE ist, sollte die HorizontalViewSize-Eigenschaft auf 100 (100 %) und die HorizontalScrollPercent-Eigenschaft auf UIA_ScrollPatternNoScroll (-1) festgelegt werden. Wenn die VerticallyScrollable-EigenschaftFALSE ist, sollte die VerticalViewSize-Eigenschaft auf 100 (100 %) und die VerticalScrollPercent-Eigenschaft auf UIA_ScrollPatternNoScroll (-1) festgelegt werden. Dadurch kann ein Microsoft Benutzeroberflächenautomatisierung-Client diese Eigenschaftswerte innerhalb der SetScrollPercent-Methode verwenden und gleichzeitig eine Racebedingung vermeiden, wenn eine Richtung aktiviert wird, in die der Client nicht scrollen möchte.
• Die IScrollProvider::HorizontalScrollPercent-Eigenschaft ist gebietsschemaspezifisch. Wenn HorizontalScrollPercent auf 100 festgelegt wird, muss die Bildlaufposition des Steuerelements auf die Äquivalente der rechtssten Position für Sprachen wie Englisch festgelegt werden, die von links nach rechts gelesen werden. Alternativ muss für Sprachen wie Arabisch, die von rechts nach links lesen, horizontalScrollPercent auf 100 festgelegt werden, die Bildlaufposition auf die äußerste linke Position festlegen.

Erforderliche Member für IScrollProvider

Die folgenden Eigenschaften und Methoden sind für die Implementierung der IScrollProvider-Schnittstelle erforderlich.

Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.

Zugehörige Themen

Steuerelementtypen und ihre unterstützten Steuerelementmuster

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur