Podpora automatizace uživatelského rozhraní pro ovládací prvek typu skupina

Poznámka:

Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy automatizace uživatelského rozhraní definované v oboru názvů System.Windows.Automation. Nejnovější informace o automatizaci uživatelského rozhraní najdete v tématu rozhraní API služby Windows Automation: Automatizace uživatelského rozhraní.

Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní pro typ ovládacího prvku Skupina. V automatizaci uživatelského rozhraní je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splnit, aby bylo možné vlastnost použít ControlTypeProperty . Tyto podmínky zahrnují specifické pokyny pro strukturu stromové struktury automatizace uživatelského rozhraní, hodnoty vlastností automatizace uživatelského rozhraní a vzory ovládacích prvků automatizace uživatelského rozhraní.

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í tak, aby položky, které jsou seskupené dohromady, měly logické rozdělení v rámci stromu Automatizace uživatelského rozhraní.

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 Skupina. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky skupiny, ať už windows Presentation Foundation (WPF), Win32 nebo Windows Forms.

Požadovaná struktura stromu automatizace uživatelského rozhraní

Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení 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í najdete 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 mají obvykle podporu automatizace uživatelského rozhraní pro typ ovládacího prvku ListItem, podporu automatizace uživatelského rozhraní pro typ ovládacího prvku TreeItem nebo podporu automatizace uživatelského rozhraní pro typy ovládacích prvků DataItem nalezené pod nimi v podstromu. Vzhledem k tomu, že group je obecný kontejner, může být jakýkoli typ ovládacího prvku pod ovládacím prvkem Skupina ve stromu.

Požadované vlastnosti automatizace uživatelského rozhraní

Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro seskupování ovládacích prvků. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Vlastnosti automatizace uživatelského rozhraní pro klienty.

Vlastnost automatizace uživatelského rozhraní	Hodnota	Poznámky
AutomationIdProperty	Viz poznámky.	Hodnota této vlastnosti musí být jedinečná pro všechny ovládací prvky v aplikaci.
BoundingRectangleProperty	Viz poznámky.	Vnější obdélník, který obsahuje celý ovládací prvek.
ClickablePointProperty	Viz poznámky.	Podporuje se, pokud existuje ohraničující obdélník. Pokud není každý bod uvnitř ohraničujícího obdélníku kliknutelný a provádíte specializované testování zásahů, můžete přepsat a poskytnout kliknutelný bod.
IsKeyboardFocusableProperty	Viz poznámky.	Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
NameProperty	Viz poznámky.	Ovládací prvek skupiny obvykle získá jeho název z textu, který tento ovládací prvek označí.
LabeledByProperty	Viz poznámky.	Ovládací prvky skupiny jsou obvykle samolepící popisky. V těchto případech vraťte null sem. Pokud existuje statický textový popisek pro skupinu, musí být vrácen jako hodnota vlastnosti LabeledBy.
ControlTypeProperty	Skupina	Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
LocalizedControlTypeProperty	skupina	Lokalizovaný řetězec, který odpovídá typu ovládacího prvku "Skupina".
IsContentElementProperty	Pravdivé	Ovládací prvek skupiny je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní.
IsControlElementProperty	Pravdivé	Skupina kalendářů je vždy součástí zobrazení ovládacího prvku stromu Automatizace uživatelského rozhraní.

Požadované vzory ovládacích prvků automatizace uživatelského rozhraní

V následující tabulce jsou uvedeny vzory ovládacích prvků automatizace uživatelského rozhraní, které musí být podporovány pro typ ovládacího prvku Skupina. Další informace o vzorech ovládacích prvků naleznete 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 vzor Rozbalit/Sbalit.

Požadované události automatizace uživatelského rozhraní

Následující tabulka uvádí události automatizace uživatelského rozhraní, které musí podporovat všechny ovládací prvky skupiny. Další informace o událostech naleznete v tématu Přehled událostí automatizace uživatelského rozhraní.

Událost automatizace uživatelského rozhraní	Podpora	Poznámky
BoundingRectangleProperty událost změny vlastnosti.	Povinné	Žádné
IsOffscreenProperty událost změny vlastnosti.	Povinné	Žádné
IsEnabledProperty událost změny vlastnosti.	Povinné	Žádné
ExpandCollapseStateProperty událost změny vlastnosti.	Závisí	Žádné
ToggleStateProperty událost změny vlastnosti.	Závisí	Žádné
AutomationFocusChangedEvent	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné

Viz také

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