Model ovládacího prvku Scroll

Popisuje pokyny a konvence pro implementaci IScrollProvider, včetně informací o vlastnostech a metodách. Vzor ovládacího prvku Scroll slouží k podpoře ovládacího prvku, který funguje jako posuvný kontejner pro kolekci podřízených objektů.

Ovládací prvek není nutný k použití posuvníků pro podporu funkce posouvání, i když to obvykle dělá. Následující obrázek znázorňuje ovládací prvek posouvání, který nepoužívá posuvníky. Příklady ovládacích prvků, které tento vzor ovládacích prvků implementují, najdete v tématu typy ovládacích prvků a jejich podporované vzory ovládacích prvků.

Toto téma obsahuje následující části.

• pokyny k implementaci a konvence
• požadované členy pro IScrollProvider
• související témata

Pokyny a konvence implementace

Při implementaci vzoru ovládacích prvků Scroll si všimněte následujících pokynů a konvencí:

• Podřízené položky tohoto ovládacího prvku musí implementovat IScrollItemProvider.
• Posuvníky ovládacího prvku kontejneru nepodporují vzor ovládacích prvků Scroll. Místo toho musí podporovat řídicí vzor RangeValue.
• Při posouvání se měří v procentech, musí být všechny hodnoty nebo částky související s dokončením posouvání normalizovány do rozsahu 0 až 100.
• Vlastnost IScrollProvider::HorizontallyScrollable a vlastnost VerticallyScrollable jsou nezávislé na vlastnosti IsEnabled.
• Pokud IScrollProvider::HorizontallyScrollable vlastnost je FALSE, vlastnost HorizontalViewSize by měla být nastavena na 100 (100%) a HorizontalScrollPercent vlastnost by měla být nastavena na UIA_ScrollPatternNoScroll (-1). Podobně pokud je vlastnost VerticallyScrollableFALSE, vlastnost VerticalViewSize by měla být nastavena na 100 (100%) a vlastnost VerticalScrollPercent by měla být nastavena na UIA_ScrollPatternNoScroll (-1). To umožňuje klientovi Microsoft UI Automation používat tyto hodnoty vlastností v rámci metody SetScrollPercent a vyhnout se konfliktu časování, pokud se aktivuje směr, který klient nemá zájem o posouvání.
• Vlastnost IScrollProvider::HorizontalScrollPercent je specifická pro národní prostředí. Nastavení HorizontalScrollPercent na hodnotu 100 musí nastavit umístění posouvání ovládacího prvku na ekvivalentní pozici nejvíce vpravo pro jazyky, jako je angličtina, která čte zleva doprava. V případě jazyků, jako je arabština, které čtou zprava doleva, musí nastavení HorizontalScrollPercent na hodnotu 100 nastavit umístění posouvání na pozici úplně vlevo.

Požadované členy pro IScrollProvider

Pro implementaci rozhraní IScrollProvider jsou vyžadovány následující vlastnosti a metody.

Tento vzor ovládacího prvku nemá žádné přidružené události.

Související témata

typy ovládacích prvků a jejich podporované vzory ovládacích prvků

Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní

Přehled stromu automatizace uživatelského rozhraní