Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku TreeItem

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 TreeItem. 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 TreeItem představuje uzel v kontejneru stromu. Každý uzel může 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 TreeItem. Požadavky na automatizaci uživatelského rozhraní se vztahují na všechny ovládací prvky stromové položky, ať už jsou to 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ů položek 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
TreeItem - Zaškrtávací políčko (0 nebo 1) - Obrázek (0 nebo 1) - Tlačítko (0 nebo 1) - TreeItem (0 nebo více)	TreeItem - TreeItem (0 nebo více)

Ovládací prvky stromové položky můžou mít v zobrazení obsahu stromu Automatizace uživatelského rozhraní nula nebo více podřízených položek stromu stromové struktury. Pokud má ovládací prvek stromové položky funkce nad rámec toho, co je vystaveno v níže uvedených vzorech ovládacích prvků, měl by být ovládací prvek založený na typu ovládacího prvku Data Item.

Sbalené položky stromu se nezobrazí v zobrazení ovládacího prvku ani v zobrazení obsahu, dokud nebudou rozbaleny a viditelné (nebo dokud je nelze posunout do zobrazení).

Zobrazení ovládacího prvku může obsahovat další podrobnosti ovládacího prvku, včetně přidruženého obrázku nebo tlačítka. Například položka v zobrazení osnovy může obsahovat obrázek i tlačítko pro rozbalení nebo sbalení osnovy. Tyto objekty podrobností se v zobrazení obsahu nezobrazují, protože informace jsou již reprezentovány nadřazenou položkou stromu. Položky stromu, které jsou posunuty mimo obrazovku, se zobrazí jak v zobrazení ovládacího prvku, tak v zobrazení obsahu stromu automatizace uživatelského prostředí, a měly by mít IsOffscreenProperty nastaveno na true.

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.	Tato vlastnost musí vrátit umístění položky, které způsobí, že položka změní stav výběru nebo se zaměří.
ControlTypeProperty	TreeItem	Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
IsContentElementProperty	Pravdivé	Ovládací prvek seznam je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní.
IsControlElementProperty	Pravdivé	Ovládací prvek seznam je vždy součástí zobrazení ovládacího prvku stromu Automatizace uživatelského rozhraní.
IsOffscreenProperty	Viz poznámky.	Tato vlastnost je nastavena tak, aby indikovala, kdy je ovládací prvek stromové položky posunut mimo obrazovku.
IsKeyboardFocusableProperty	Viz poznámky.	Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
ItemTypeProperty	Viz poznámky.	Pokud ovládací prvek položky stromu používá vizuální ikonu k označení, že se jedná o konkrétní typ objektu, musí být tato vlastnost podporována a indikovat, co je ten objekt.
LabeledByProperty	Null	Ovládací prvky stromové položky jsou vlastní popisky.
LocalizedControlTypeProperty	položka stromu	Lokalizovaný řetězec odpovídající typu ovládacího prvku TreeItem.
NameProperty	Viz poznámky.	Tato vlastnost zveřejňuje text zobrazený pro každý ovládací prvek položky stromu.

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
IInvokeProvider	Závisí	Implementujte tento vzor ovládacího prvku, pokud má položka stromu samostatný příkaz umožňující akci.
IExpandCollapseProvider	Ano	Všechny položky stromu je možné rozbalit nebo sbalit.
ExpandCollapseState	Rozbalený, sbalený nebo listový uzel	Položky stromu budou uzly typu list, pokud nejsou rozbalené nebo sbalené.
IScrollItemProvider	Závisí	Implementujte tento vzor ovládacího prvku, pokud kontejner stromu podporuje vzor ovládacího prvku Scroll.
ISelectionItemProvider	Závisí	Implementujte tento vzor ovládacího prvku, pokud je možné mít aktivní výběr, který je zachován, když se uživatel vrátí do kontejneru stromu.
SelectionContainer	Ano	Tato vlastnost zpřístupní stejný kontejner pro všechny položky v kontejneru.
IToggleProvider	Závisí	Implementujte tento vzor ovládacího prvku, pokud má položka stromu přidružené zaškrtávací políčko.

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 stromové položky. 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
AutomationFocusChangedEvent	Povinné	Žádné
BoundingRectangleProperty událost změny vlastnosti.	Povinné	Žádné
IsEnabledProperty událost změny vlastnosti.	Povinné	Žádné
IsOffscreenProperty událost změny vlastnosti.	Povinné	Žádné
ItemStatusProperty událost změny vlastnosti.	Závisí	Žádné
NameProperty událost změny vlastnosti.	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné
ExpandCollapseStateProperty událost změny vlastnosti.	Povinné	Žádné
InvokedEvent	Závisí	Žádné
CurrentViewProperty událost změny vlastnosti.	Závisí	Žádné
ElementAddedToSelectionEvent	Závisí	Žádné
ElementRemovedFromSelectionEvent	Závisí	Žádné
ElementSelectedEvent	Závisí	Žádné
ToggleStateProperty událost změny vlastnosti.	Závisí	Žádné
ValueProperty událost změny vlastnosti.	Závisí	Žádné

Viz také

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