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 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 poskytuje informace o podpoře automatizace uživatelského rozhraní pro typ ovládacího prvku Tree. 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 . Podmínky zahrnují specifické pokyny pro strukturu stromu automatizace uživatelského rozhraní, hodnoty vlastností automatizace uživatelského rozhraní 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 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 stromu včetně 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ů stromu, 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
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 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 dvě posuvné lišty.

Zobrazení obsahu stromu Automatizace uživatelského rozhraní se skládá z nuly nebo mnoha 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).

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 ovládací prvky seznamu. 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.	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	Pravdivé	Ovládací prvek strom je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní.
IsControlElementProperty	Pravdivé	Ovládací prvek strom je vždy součástí zobrazení ovládacího prvku stromu automatizace uživatelského rozhraní.
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á stromový ovládací prvek přidružený popisek, vrátí tato vlastnost AutomationElement pro ten 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ů automatizace uživatelského rozhraní

Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které jsou potřeba k podpoře ovládacích prvků seznamu. 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
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 tuto šablonu ovládacího prvku, pokud lze posouvat obsah kontejneru stromu.

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 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í	Podpora	Poznámky
InvalidatedEvent	Závisí	Žádné
BoundingRectangleProperty událost změny vlastnosti.	Povinné	Žádné
IsOffscreenProperty událost změny vlastnosti.	Povinné	Žádné
IsEnabledProperty událost změny vlastnosti.	Povinné	Žádné
HorizontallyScrollableProperty událost změny vlastnosti.	Závisí	Žádné
HorizontalScrollPercentProperty událost změny vlastnosti.	Závisí	Žádné
HorizontalViewSizeProperty událost změny vlastnosti.	Závisí	Žádné
VerticalScrollPercentProperty událost změny vlastnosti.	Závisí	Žádné
VerticallyScrollableProperty událost změny vlastnosti.	Závisí	Žádné
VerticalViewSizeProperty událost změny vlastnosti.	Závisí	Žádné
AutomationFocusChangedEvent	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné

Viz také

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