Bildlauf-Steuerelementmuster

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

Das Steuerelement ist nicht erforderlich, um Bildlaufleisten zu verwenden, um die Bildlauffunktion zu unterstützen, obwohl es häufig 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 deren unterstützte Steuerelementmuster.

Dieses Thema enthält die folgenden Abschnitte.

• Implementierungsrichtlinien und -konventionen
• Erforderliche Member für IScrollProvider-
• Verwandte Themen

Implementierungsrichtlinien und -konventionen

Beachten Sie bei der Implementierung des Scroll- Steuerelementmusters die folgenden Richtlinien und Konventionen:

• Die untergeordneten Elemente dieses Steuerelements müssen IScrollItemProviderimplementieren.
• Die Bildlaufleisten eines Containersteuerelements unterstützen das Bildlauf- Steuerelementmusters nicht. Sie müssen stattdessen das RangeValue- Steuerelementmuster unterstützen.
• Wenn der Bildlauf in Prozent gemessen wird, müssen alle Werte oder Beträge im Zusammenhang mit der Graduierung des Bildlaufs auf einen Bereich von 0 bis 100 normalisiert werden.
• Die IScrollProvider::HorizontallyScrollable-Eigenschaft und VerticallyScrollable-Eigenschaft sind unabhängig von der IsEnabled--Eigenschaft.
• Wenn die IScrollProvider::HorizontallyScrollable-Eigenschaft FALSE-ist, sollte die HorizontalViewSize-Eigenschaft auf 100 (100%) festgelegt werden und HorizontalScrollPercent-Eigenschaft auf UIA_ScrollPatternNoScroll (-1) festgelegt werden. Wenn die VerticallyScrollable-Eigenschaft FALSE-ist, sollte die VerticalViewSize-Eigenschaft auf 100 (100%) festgelegt werden und VerticalScrollPercent-Eigenschaft auf UIA_ScrollPatternNoScroll (-1) festgelegt werden. Auf diese Weise kann ein Microsoft-Benutzeroberflächenautomatisierungs-Client diese Eigenschaftswerte innerhalb der SetScrollPercent--Methode verwenden, während eine Racebedingung vermieden wird, wenn eine Richtung aktiviert wird, die der Client nicht für das Scrollen interessiert.
• Die IScrollProvider::HorizontalScrollPercent-Eigenschaft ist gebietsschemaspezifisch. Wenn Sie HorizontalScrollPercent- auf 100 festlegen, muss die Bildlaufposition des Steuerelements auf das Äquivalent der position ganz rechts 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 gelesen werden, HorizontalScrollPercent- auf 100 festgelegt werden, die Bildlaufposition auf die äußerst linke Position festgelegt werden.

Erforderliche Elemente für IScrollProvider-

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

Dieses Steuerelementmuster hat keine zugehörigen Ereignisse.

Verwandte Themen

Steuerelementtypen und deren unterstützte Steuerelementmuster

Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung

übersicht über Benutzeroberflächenautomatisierungsstruktur