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 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 TreeItem. 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 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 model UI Automation stromovou strukturu, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku TreeItem. Požadavky na model UI Automation platí pro všechny ovládací prvky stromové položky, 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ů položek 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 |
|---|---|
| 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 model UI Automation stromu nula nebo více podřízených položek stromu. 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é stromové položky se nezobrazí v zobrazení ovládacího prvku nebo v zobrazení obsahu, dokud nebudou rozbalené a viditelné (nebo je možné je 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í v ovládacím prvku i v zobrazení obsahu stromu model UI Automation a měly by mít nastavenou IsOffscreenProperty hodnotu true.
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. | 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 | True | Ovládací prvek seznam je vždy součástí zobrazení obsahu model UI Automation stromu. |
| IsControlElementProperty | True | Ovládací prvek seznam je vždy součástí zobrazení ovládacího prvku stromu model UI Automation. |
| 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á ikonu vizuálu k označení, že je konkrétním typem objektu, musí být tato vlastnost podporována a indikovat, co objekt je. |
| LabeledByProperty | Null |
Ovládací prvky stromové položky jsou vlastní popisky. |
| LocalizedControlTypeProperty | "stromová položka" | 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ů 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 |
|---|---|---|
| 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 model UI Automation
Následující tabulka uvádí model UI Automation události, které musí podporovat všechny ovládací prvky položek stromové struktury. Další informace oudálostch model UI Automation ch
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| AutomationFocusChangedEvent | Požaduje se | Nic |
| BoundingRectangleProperty událost změněná vlastností. | Požaduje se | Nic |
| IsEnabledProperty událost změněná vlastností. | Požaduje se | Nic |
| IsOffscreenProperty událost změněná vlastností. | Požaduje se | Nic |
| ItemStatusProperty událost změněná vlastností. | Závisí | Nic |
| NameProperty událost změněná vlastností. | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |
| ExpandCollapseStateProperty událost změněná vlastností. | Požaduje se | Nic |
| InvokedEvent | Závisí | Nic |
| CurrentViewProperty událost změněná vlastností. | Závisí | Nic |
| ElementAddedToSelectionEvent | Závisí | Nic |
| ElementRemovedFromSelectionEvent | Závisí | Nic |
| ElementSelectedEvent | Závisí | Nic |
| ToggleStateProperty událost změněná vlastností. | Závisí | Nic |
| ValueProperty událost změněná vlastností. | Závisí | Nic |