Sdílet prostřednictvím

Typ ovládacího prvku skupiny

  • Článek

Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku Group.

Ovládací prvek skupiny představuje uzel v hierarchii. Typ ovládacího prvku Skupina vytvoří oddělení ve stromu automatizace uživatelského rozhraní, aby položky, které jsou seskupené dohromady, měly v rámci stromu automatizace uživatelského rozhraní logickou dělení.

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 Group. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky skupiny, 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ů skupiny, 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
  • Skupina
    • 0 nebo mnoho ovládacích prvků
  • Skupina
    • 0 nebo mnoho ovládacích prvků

 

Ovládací prvky skupiny obvykle zahrnují podporu automatizace uživatelského rozhraní pro typy ovládacích prvků nalezené pod nimi v podstromu, včetně ListItem, TreeItema DataItem typy ovládacích prvků. Vzhledem k tomu, že ovládací prvek skupiny je obecný kontejner, může být jakýkoli typ ovládacího prvku pod ovládacím prvkem skupiny ve stromu.

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 skupiny. 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. Podporuje se, pokud existuje ohraničující obdélník. Pokud ne každý bod uvnitř ohraničujícího obdélníku je možné kliknout a prvek provádí specializované testování hitů, přepište a poskytněte kliknutelný bod.
UIA_ControlTypePropertyId skupiny
UIA_IsContentElementPropertyId TRUE Ovládací prvek skupiny je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní.
UIA_IsControlElementPropertyId TRUE Ovládací prvek skupiny 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. Ovládací prvky skupiny jsou obvykle samolepící popisky. V těchto případech vrátí null. Pokud má skupina statický textový popisek, vraťte popisek jako hodnotu vlastnosti LabeledBy.
UIA_LocalizedControlTypePropertyId Viz poznámky. Lokalizovaný řetězec odpovídající typu ovládacího prvku Group. Výchozí hodnota je "group" pro en-US nebo angličtinu (Spojené státy).
UIA_NamePropertyId Viz poznámky. Ovládací prvek skupiny obvykle získá jeho název z textu, který tento ovládací prvek označí.

 

Požadované vzory ovládacích prvků

Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které se musí podporovat pro typ ovládacího prvku Group. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.

Vzor ovládacího prvku Podpora Poznámky
IExpandCollapseProvider Závisí Ovládací prvky skupiny, které lze použít k zobrazení nebo skrytí informací, musí podporovat ExpandCollapse vzor ovládacího prvku.

 

Požadované události

Následující tabulka uvádí události automatizace uživatelského rozhraní, které seskupují ovládací prvky 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_ExpandCollapseExpandCollapseStatePropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje ExpandCollapse vzor ovládacích prvků, musí tuto událost podporovat.
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_ToggleToggleStatePropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vzor ovládacích prvků Přepnout, 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í