Typ ovládacího prvku seznam
Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní microsoftu pro typ ovládacího prvku Seznam.
Typ ovládacího prvku Seznam poskytuje způsob uspořádání ploché skupiny nebo skupin položek a umožňuje uživateli vybrat jednu nebo více těchto položek. Typ ovládacího prvku Seznam má volné omezení na typy podřízených prvků, které může obsahovat. To umožňuje poskytovatelům automatizace uživatelského rozhraní podporovat dobře známý prvek pro kontejnery výběru.
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 List. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky seznamu, 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ých vzorů ovládacích prvků a vlastností
- 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ů seznamu, 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 |
|---|---|
| Obsahuje prvky, které odpovídají ovládacím prvkům. | Odebere ze stromu nadbytečné informace, aby technologie usnadnění fungovaly s nejmenší sadou informací, které jsou pro koncového uživatele smysluplné. |
|
|
Zobrazení ovládacího prvku, který implementuje typ ovládacího prvku Seznam (například ovládací prvek seznamu), se skládá z:
- Nula nebo více položek v ovládacím prvku seznamu (položky mohou být založeny na ListItem nebo DataItem typy ovládacích prvků)
- Nula nebo více ovládacích prvků skupiny v rámci ovládacího prvku seznamu
- Nula, jeden nebo dva ovládací prvky posuvníku
Zobrazení obsahu ovládacího prvku, který implementuje typ ovládacího prvku Seznam (například ovládací prvek seznamu) se skládá z:
- Nula nebo více položek v ovládacím prvku seznamu (položky mohou být založeny na ListItem nebo DataItem typy ovládacích prvků)
- Nula nebo více skupin v ovládacím prvku seznamu
Ovládací prvek seznamu nesmí obsahovat položky, které mají jiný hierarchický vztah než seskupování. Pokud položky mají ve stromu Automatizace uživatelského rozhraní podřízené položky, měl by být kontejner seznamu založený na typu ovládacího prvku strom.
Položky, které lze vybrat v ovládacím prvku seznamu, budou k dispozici od potomků ve stromu automatizace uživatelského rozhraní ovládacího prvku seznamu. Všechny položky v ovládacím prvku seznamu musí patřit do stejné skupiny výběru. Vybratelné položky v seznamu by měly být vystaveny jako ListItem (místo DataItem) typů ovládacích prvků.
Relevantní vlastnosti
Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro typ ovládacího prvku Seznam. 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 | Viz poznámky. | Pokud má ovládací prvek seznamu klikatelný bod (bod, na který lze kliknout, aby se seznam mohl zaměřit), musí být tento bod zpřístupněn prostřednictvím této vlastnosti. Pokud je hodnota vlastnosti UIA_IsOffscreenPropertyIdTRUE, při pokusu o načtení této vlastnosti dojde k chybě UIA_E_NOCLICKABLEPOINT. |
| UIA_ControlTypePropertyId | seznamu | |
| UIA_HelpTextPropertyId | Viz poznámky. | Text nápovědy k ovládacím prvkům seznamu by měl vysvětlit, proč se uživateli zobrazí výzva k výběru ze seznamu možností. Například "Výběr položky z tohoto seznamu nastaví rozlišení zobrazení pro váš monitor". |
| UIA_IsContentElementPropertyId | TRUE | Ovládací prvek seznam je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní. |
| UIA_IsControlElementPropertyId | TRUE | Ovládací prvek seznam 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. |
| UIA_LabeledByPropertyId | Viz poznámky. | Pokud je popisek statického textu, musí tato vlastnost vystavit odkaz na tento ovládací prvek. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající typu ovládacího prvku Seznam. Výchozí hodnota je "list" pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | Viz poznámky. | Hodnota vlastnosti Název ovládacího prvku seznamu by měla sdělit kategorii možností, ze které má uživatel vybírat. Tato vlastnost obvykle získá název ze statického textového popisku. Pokud není popisek statického textu, vývojář aplikace musí vystavit hodnotu pro vlastnost Name. Jedinou dobou, kdy tato vlastnost není vyžadována pro ovládací prvky seznamu, je-li ovládací prvek použit v podstrom jiného ovládacího prvku. |
Požadované vzory a vlastnosti ovládacích prvků
Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které musí být podporovány všemi ovládacími prvky seznamu. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.
| Vlastnost vzoru ovládacího prvku nebo vzoru | Podpora/hodnota | Poznámky |
|---|---|---|
| IGridProvider | Závisí | Implementujte vzor ovládacího prvku Mřížka, pokud je potřeba, aby navigace v mřížce byla k dispozici pro položku podle položek. |
| IMultipleViewProvider | Závisí | Implementujte MultipleView vzor ovládacího prvku, pokud může ovládací prvek podporovat více zobrazení položek v kontejneru. |
| IScrollProvider | Závisí | Implementujte vzor ovládacího prvku Scroll, pokud jsou položky v kontejneru posuvné. |
| ISelectionProvider | Závisí | Pokud ovládací prvek podporuje typ ovládacího prvku Seznam, který podporuje výběr, musí ovládací prvek implementovat Výběr vzor ovládacího prvku při zachování stavu výběru mezi položkami obsaženými v ovládacím prvku. Pokud položky v ovládacím prvku nelze vybrat, lze použít typ ovládacího prvku Skupina. |
| CanSelectMultiple | Závisí | Ovládací prvky seznamu můžou být kontejnery s jedním nebo vícenásobným výběrem. |
| IsSelectionRequired | Závisí | Ovládací prvky seznamu nevyžadují vždy, aby byla vybrána položka. |
| ITableProvider | Nikdy | Vzor ovládacího prvku tabulky není nikdy podporován pro typ ovládacího prvku Seznam. Pokud ovládací prvek potřebuje podporovat tento vzor ovládacího prvku, měl by být založen na typu ovládacího prvku DataGrid. |
Požadované události
Následující tabulka uvádí události automatizace uživatelského rozhraní, které vyžadují podporu ovládacích prvků seznamu. 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_LayoutInvalidatedEventId | Pokud lze změnit rozložení podřízených položek, ovládací prvek musí tuto událost podporovat. |
| UIA_MultipleViewCurrentViewPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje MultipleView vzor ovládacího prvku, musí tuto událost podporovat. |
| UIA_ScrollHorizontallyScrollablePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat. |
| UIA_ScrollHorizontalScrollPercentPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat. |
| UIA_ScrollHorizontalViewSizePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat. |
| UIA_ScrollVerticalScrollPercentPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat. |
| UIA_ScrollVerticallyScrollablePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat. |
| UIA_ScrollVerticalViewSizePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat. |
| UIA_Selection_InvalidatedEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku Výběr, musí tuto událost podporovat. |
| UIA_StructureChangedEventId |