Typ ovládacího prvku ScrollBar
Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku ScrollBar.
Ovládací prvky posuvníku umožňují uživateli posouvat obsah v okně nebo kontejneru položek. Ovládací prvek se skládá ze sady tlačítek a ovládacího prvku palce.
Následující části definují požadovanou strukturu stromu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Scroll Bar. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky posuvníku, ve kterých architektura uživatelského rozhraní nebo platforma integruje podporu automatizace uživatelského rozhraní pro typy ovládacích prvků a vzory ovládacích prvků.
Toto téma obsahuje následující části.
- typické stromové struktury
- relevantních vlastností
- požadované vzory ovládacích prvků
- požadovaných událostí
- související témata
Typická stromová struktura
Následující tabulka znázorňuje typické ovládací prvky a zobrazení obsahu stromu Automatizace uživatelského rozhraní, které se týká ovládacích prvků posuvníku a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu automatizace uživatelského rozhraní naleznete v tématu přehled stromu automatizace uživatelského rozhraní.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
|
Nelze použít. (Ovládací prvek posuvníku nemá žádný obsah.) |
Ovládací prvek posuvníku může mít nula až pět podřízených položek. Vzhledem k tomu, že podstrom má více než jeden ovládací prvek tlačítka, musí prvek nastavit konkrétní UIA_AutomationIdPropertyId hodnotu pro každou položku, aby je bylo možné zjistit pro automatizované testovací nástroje.
Relevantní vlastnosti
Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky posuvníku. Všimněte si, že ovládací prvek posuvníku nikdy nemá obsah; jeho funkce jsou zpřístupněny prostřednictvím Scroll řídicí vzor, který je podporován při posouvání kontejneru.
Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Načítání vlastností z prvků automatizace uživatelského rozhraní.
| Vlastnost automatizace uživatelského rozhraní | Hodnota | Poznámky |
|---|---|---|
| UIA_AutomationIdPropertyId | Viz poznámky. | Hodnota této vlastnosti musí být jedinečná mezi všemi partnerskými prvky v nezpracovaného zobrazení stromu automatizace uživatelského rozhraní. |
| UIA_BoundingRectanglePropertyId | Viz poznámky. | Vnější obdélník, který obsahuje celý ovládací prvek. |
| UIA_ClickablePointPropertyId | Nan | Ovládací prvek posuvníku nemá klikatelné body. |
| UIA_ControlTypePropertyId | posuvníku | Tato hodnota je stejná pro všechny architektury. Posuvníky, které fungují jako posuvníky, musí používat typ ovládacího prvku Posuvník. |
| UIA_IsContentElementPropertyId | FALEŠNÝ | Ovládací prvek posuvníku není nikdy prvkem obsahu. Pokud je posuvník samostatný ovládací prvek, musí splňovat typ ovládacího prvku Posuvník a vrátit UIA_SliderControlTypeId pro vlastnost IUIAutomationElement::CurrentControlType (nebo CachedControlType). |
| UIA_IsControlElementPropertyId | PRAVDIVÝ | Ovládací prvek posuvníku je vždy součástí zobrazení ovládacího prvku stromu Automatizace uživatelského rozhraní. |
| UIA_IsKeyboardFocusablePropertyId | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. Ovládací prvek posuvníku zřídka vezme fokus, ale pokud ano, fokus by měl zůstat na samotném ovládacím prvku posuvníku, ne na podřízených tlačítkách nebo na palec. Uživatel by měl mít možnost provádět všechny akce posouvání pomocí kláves ŠIPKA NAHORU a ŠIPKA DOLŮ (nebo ŠIPKA VPRAVO a ŠIPKA VLEVO) nebo KLÁVESY PAGE UP a PAGE DOWN. |
| UIA_LabeledByPropertyId | NULA | Posuvníky nemají popisky. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající ScrollBar typ ovládacího prvku. Výchozí hodnota je "posuvník" pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | NULA | Ovládací prvek posuvníku neobsahuje prvky obsahu a vlastnost UIA_NamePropertyId není nutné nastavit. |
| UIA_OrientationPropertyId | Viz poznámky. | Ovládací prvek posuvníku musí vždy vystavit jeho vodorovnou nebo svislou orientaci. |
Požadované vzory ovládacích prvků
Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které musí podporovat všechny ovládací prvky posuvníku. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.
Poznámka
Pokud se posuvník používá pouze jako ovládací prvek pro manipulaci s myší, nepodporuje vzory ovládacích prvků. Pokud se používá jako ovládací prvek posuvníku v aplikaci, musí být uveden typ ovládacího prvku Posuvník.
| Vzor ovládacího prvku | Podpora | Poznámky |
|---|---|---|
| IRangeValueProvider | Závisí | Vzor ovládacích prvků RangeValue se vyžaduje pouze v případě, že v kontejneru s posuvníkem není podporovaný vzor ovládacích prvků Scroll. |
| IScrollProvider | Nikdy | Vzor ovládacího prvku Scroll se nikdy přímo nepodporuje na posuvníku. |
Požadované události
Následující tabulka uvádí události automatizace uživatelského rozhraní, které ovládací prvky posuvníku vyžadují pro podporu. Další informace o událostech najdete v tématu Přehled událostí automatizace uživatelského rozhraní.
| Událost automatizace uživatelského rozhraní | Poznámky |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId událost změněnou vlastností. | |
| UIA_IsEnabledPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsEnabled, musí tuto událost podporovat. |
| UIA_IsOffscreenPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat. |
| UIA_StructureChangedEventId | |
| UIA_RangeValueValuePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje RangeValue vzor ovládacího prvku, musí tuto událost podporovat. |
Související témata