Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku skupina
Poznámka:
Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy model UI Automation definované v System.Windows.Automation oboru názvů. Nejnovější informace o model UI Automation najdete v tématu Rozhraní API služby Windows Automation: model UI Automation.
Toto téma obsahuje informace o podpoře model UI Automation pro typ ovládacího prvku Skupina. V model UI Automation je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splňovat, aby bylo možné vlastnost použítControlTypeProperty. Podmínky zahrnují specifické pokyny pro strukturu stromové struktury model UI Automation, model UI Automation hodnoty vlastností a vzory ovládacích prvků model UI Automation.
Ovládací prvek skupiny představuje uzel v hierarchii. Typ ovládacího prvku Skupina vytvoří oddělení ve stromu model UI Automation tak, aby položky, které jsou seskupené dohromady, měly logické dělení v rámci model UI Automation stromu.
Následující části definují požadovanou model UI Automation stromovou strukturu, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Skupina. Požadavky na model UI Automation platí pro všechny ovládací prvky skupiny, ať už windows Presentation Foundation (WPF), Win32 nebo model Windows Forms.
Požadovaná struktura stromu model UI Automation
Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení obsahu stromu model UI Automation, 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 model UI Automation naleznete v tématu model UI Automation Strom přehledu.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
| Seskupit - 0 nebo mnoho ovládacích prvků |
Seskupit - 0 nebo mnoho ovládacích prvků |
Ovládací prvky skupiny mají obvykle model UI Automation Podporu pro typ ovládacího prvku ListItem, model UI Automation Podpora pro typ ovládacího prvku TreeItem nebo model UI Automation Podpora typů ovládacích prvků DataItem nalezených 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 model UI Automation
Následující tabulka uvádí model UI Automation vlastnosti, jejichž hodnota nebo definice jsou zvláště relevantní pro seskupování ovládacích prvků. Další informace o model UI Automation vlastnosti naleznete v tématu model UI Automation Vlastnosti pro klienty.
| vlastnost model UI Automation | Hodnota | Notes |
|---|---|---|
| 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 ne každý bod uvnitř ohraničujícího obdélníku je možné kliknout a provést specializované testování hitů, pak 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 se sem vraťte null . Pokud je pro skupinu statický textový popisek, musí být vrácen jako hodnota LabeledBy vlastnost. |
| ControlTypeProperty | Seskupit | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| LocalizedControlTypeProperty | "group" | Lokalizovaný řetězec odpovídající typu ovládacího prvku Skupina. |
| IsContentElementProperty | True | Ovládací prvek skupiny je vždy součástí zobrazení obsahu stromu model UI Automation. |
| IsControlElementProperty | True | Skupina kalendářů je vždy zahrnuta v ovládacím zobrazení stromu model UI Automation. |
Požadované vzory ovládacích prvků model UI Automation
V následující tabulce jsou uvedeny vzory ovládacích prvků model UI Automation, které je nutné pro typ ovládacího prvku Skupina podporovat. Další informace o vzorech ovládacích prvků najdete v tématu model UI Automation Přehled vzorů ovládacích prvků.
| Vzor ovládacího prvku | Technická podpora | Notes |
|---|---|---|
| IExpandCollapseProvider | Závisí | Ovládací prvky skupiny, které lze použít k zobrazení nebo skrytí informací, musí podporovat vzorec Rozbalit sbalit. |
Požadované události model UI Automation
Následující tabulka uvádí model UI Automation události, které musí podporovat všechny ovládací prvky skupiny. Další informace oudálostch model UI Automation ch
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| BoundingRectangleProperty událost změněná vlastností. | Požaduje se | Nic |
| IsOffscreenProperty událost změněná vlastností. | Požaduje se | Nic |
| IsEnabledProperty událost změněná vlastností. | Požaduje se | Nic |
| ExpandCollapseStateProperty událost změněná vlastností. | Závisí | Nic |
| ToggleStateProperty událost změněná vlastností. | Závisí | Nic |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |