Sdílet prostřednictvím

Typ ovládacího prvku strom

  • Článek

Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní microsoftu pro typ ovládacího prvku Strom.

Typ ovládacího prvku strom se používá pro kontejnery, jejichž obsah má význam jako hierarchie uzlů, stejně jako způsob zobrazení souborů a složek v levém podokně Průzkumníka Windows. Každý uzel má potenciál obsahovat další uzly označované jako podřízené uzly. Nadřazené uzly nebo uzly, které obsahují podřízené uzly, se dají zobrazit jako rozbalené nebo sbalené. Ovládací prvek stromového zobrazení Windows (jak je identifikováno WC_TREEVIEW) je příkladem ovládacího prvku, který patří do typu ovládacího prvku Strom.

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 Strom. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky stromové položky, 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á struktura

Následující tabulka znázorňuje typické zobrazení ovládacího prvku a obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacích prvků stromu, 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
  • Strom
    • DataItem (0 nebo více)
    • TreeItem (0 nebo více)
      • TreeItem (0 nebo více)
        • ...
    • Posuvník (0, 1, 2)
  • Strom
    • DataItem (0 nebo více)
    • TreeItem (0 nebo více)
      • TreeItem (0 nebo více)
        • ...

 

Zobrazení ovládacího prvku stromu Automatizace uživatelského rozhraní se skládá z:

  • Nula z mnoha položek v kontejneru (položky mohou být založeny na TreeItem nebo DataItem typy ovládacích prvků).
  • Nula, jeden nebo dva ovládací prvky posuvníku

Zobrazení obsahu stromu Automatizace uživatelského rozhraní se skládá z nuly nebo mnoha položek v kontejneru (položky mohou být založeny na TreeItem nebo DataItem typy 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 Strom. 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. Ovládací prvky stromu mají kliknutelný bod, který způsobí, že strom nebo jedna z položek ve stromovém kontejneru obdrží fokus. Ovládací prvek stromu může mít kliknutelný bod pouze v případě, že je možné kliknout na umístění ve stromu, aniž by bylo možné vybrat položku nebo získat fokus.
UIA_ControlTypePropertyId stromové Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
UIA_IsContentElementPropertyId PRAVDIVÝ Ovládací prvek strom je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní.
UIA_IsControlElementPropertyId PRAVDIVÝ Ovládací prvek strom 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 má ovládací prvek strom přidružený popisek, tato vlastnost vrátí IUIAutomationElement ukazatel tohoto popisku. V opačném případě vrátí vlastnost nulový odkaz.
UIA_LocalizedControlTypePropertyId Viz poznámky. Lokalizovaný řetězec odpovídající typu ovládacího prvku Strom. Výchozí hodnota je "strom" pro en-US nebo angličtinu (Spojené státy).
UIA_NamePropertyId Viz poznámky. Hodnota vlastnosti názvu ovládacího prvku stromu obvykle pochází z textu, který tento ovládací prvek označuje. Pokud neexistuje žádný textový popisek, je nutné zadat hodnotu pro tuto vlastnost.

 

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 stromu. 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
IScrollProvider Závisí Implementujte vzor ovládacích prvků Scroll, pokud se položky ve stromovém kontejneru dají posunout.
ISelectionProvider Závisí Ovládací prvky stromu, které obsahují sadu vybratelných položek, musí implementovat vzor ovládacího prvku Výběr. Není nutné ji implementovat, pokud při výběru položky uživateli nejsou žádné smysluplné informace.
CanSelectMultiple Viz poznámky. Implementujte tuto vlastnost, pokud ovládací prvek stromu podporuje vícenásobný výběr (většina ovládacích prvků stromu nepodporuje vícenásobný výběr).
IsSelectionRequired Viz poznámky. Hodnota této vlastnosti je vystavena, pokud ovládací prvek vyžaduje, aby byla vybrána položka.

 

Požadované události

Následující tabulka uvádí události automatizace uživatelského rozhraní, které musí podporovat všechny ovládací prvky stromu. 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_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

 

koncepční

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

Přehled automatizace uživatelského rozhraní