Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku strom
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 Strom. 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ů.
Typ ovládacího prvku Strom se používá pro kontejnery, jejichž obsah má význam jako hierarchie uzlů, stejně jako u způsobu 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é.
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 Strom. Požadavky na model UI Automation platí pro všechny ovládací prvky stromu, 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ů stromu, 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 |
|---|---|
Strom
|
Strom
|
Zobrazení ovládacího prvku model UI Automation stromu se skládá z:
Nula až mnoho položek v kontejneru (položky můžou být založené na stromové položce, datové položce nebo jiném typu ovládacího prvku).
Nula, jeden nebo dva posuvníky.
Zobrazení obsahu model UI Automation stromu se skládá z nuly nebo mnoha položek v kontejneru (položky mohou být založené na stromové položce, datové položce nebo jiném typu ovládacího prvku).
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 ovládací prvky seznamu. 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. | Ovládací prvky stromu mají kliknutelný bod, který způsobí, že strom nebo jedna položka ve stromovém kontejneru bude mít fokus nastavený na ně. Na strom se dá kliknout jenom v případě, že můžete kliknout na místo, které nezpůsobí výběr jedné z položek nebo získání fokusu. |
| ControlTypeProperty | Strom | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| IsContentElementProperty | True | Ovládací prvek strom je vždy součástí zobrazení obsahu model UI Automation stromu. |
| IsControlElementProperty | True | Ovládací prvek strom je vždy součástí zobrazení ovládacího prvku model UI Automation stromu. |
| IsKeyboardFocusableProperty | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. |
| LabeledByProperty | Viz poznámky. | Pokud má ovládací prvek strom přidružený popisek, vrátí tato vlastnost AutomationElement tento popisek. V opačném případě tato vlastnost vrátí odkaz null (Nothing v jazyce Microsoft Visual Basic .NET). |
| LocalizedControlTypeProperty | "strom" | Lokalizovaný řetězec odpovídající typu ovládacího prvku Seznam. |
| NameProperty | 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, vývojář aplikace musí zadat hodnotu pro tuto vlastnost. |
Požadované vzory ovládacích prvků model UI Automation
Následující tabulka uvádí model UI Automation vzory ovládacích prvků vyžadované ovládacími prvky seznamu. Další informace o vzorech ovládacích prvků najdete v tématu model UI Automation Přehled vzorů ovládacích prvků.
| Vlastnost vzoru ovládacího prvku nebo vzoru | Podpora/hodnota | Notes |
|---|---|---|
| ISelectionProvider | Závisí | Ovládací prvky stromu, které obsahují sadu vybratelných položek, musí implementovat tento vzor ovládacího prvku. Tento vzor ovládacího prvku se nemusí implementovat, pokud výběr položky uživateli nepředá 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. |
| IScrollProvider | Závisí | Implementujte tento vzor ovládacího prvku, pokud lze posunout obsah kontejneru stromu. |
Požadované události model UI Automation
Následující tabulka uvádí model UI Automation události, které musí být podporovány všemi ovládacími prvky stromové struktury. Další informace o událostech najdete v tématu model UI Automation Přehled událostí.
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| InvalidatedEvent | Závisí | Nic |
| 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 |
| HorizontallyScrollableProperty událost změněná vlastností. | Závisí | Nic |
| HorizontalScrollPercentProperty událost změněná vlastností. | Závisí | Nic |
| HorizontalViewSizeProperty událost změněná vlastností. | Závisí | Nic |
| VerticalScrollPercentProperty událost změněná vlastností. | Závisí | Nic |
| VerticallyScrollableProperty událost změněná vlastností. | Závisí | Nic |
| VerticalViewSizeProperty událost změněná vlastností. | Závisí | Nic |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |