Scroll-Steuerelementmuster
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 von untergeordneten Objekten fungiert.
Das Steuerelement ist nicht erforderlich, um Scrollleisten zu verwenden, um die Scrollfunktion zu unterstützen, obwohl dies üblicherweise erfolgt. Die folgende Abbildung zeigt ein Bildlaufsteuerelement, das keine Bildlaufleisten verwendet. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und deren unterstützte 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 IScrollItemProviderimplementieren.
- 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 IScrollProvider::HorizontallyScrollable-Eigenschaft und die VerticallyScrollable-Eigenschaft sind unabhängig von der IsEnabled-Eigenschaft.
- Wenn die IScrollProvider::HorizontallyScrollable-Eigenschaft FALSE ist, sollte die HorizontalViewSize-Eigenschaft auf 100 (100 %) und die HorizontalScrollPercent-Eigenschaft auf UIA _ ScrollPatternNoScroll (-1) festgelegt werden. Wenn die VerticallyScrollable-Eigenschaft FALSE 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, während eine Racebedingung vermieden wird, wenn eine Richtung aktiviert wird, in der 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 rechten 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, um die Bildlaufposition auf die äußerste linke Position festzulegen.
Erforderliche Member für IScrollProvider
Die folgenden Eigenschaften und Methoden sind für die Implementierung der IScrollProvider-Schnittstelle erforderlich.
| Erforderliche Member | Memberart | Hinweise |
|---|---|---|
| HorizontalScrollPercent | Eigenschaft | Keine |
| VerticalScrollPercent | Eigenschaft | Keine |
| HorizontalViewSize | Eigenschaft | Keine |
| VerticalViewSize | Eigenschaft | Keine |
| HorizontallyScrollable | Eigenschaft | Keine |
| VerticallyScrollable | Eigenschaft | Keine |
| Blättern | Methode | Keine |
| SetScrollPercent | Methode | Keine |
Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.