Typ ovládacího prvku TreeItem
Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní Microsoftu pro typ ovládacího prvku TreeItem.
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í platí pro všechny ovládací prvky stromové položky, ve kterých architektura uživatelského rozhraní nebo platforma integruje podporu automatizace uživatelského rozhraní pro typy ovládacích prvků a vzory ovládacích prvků.
Toto téma obsahuje následující části.
- typické stromové struktury
- relevantních vlastností
- požadované vzory ovládacích prvků
- požadovaných událostí
- poznámky
- související témata
Typická stromová struktura
Následující tabulka znázorňuje typické zobrazení ovládacího prvku a obsahu stromu Automatizace uživatelského rozhraní, které se týká ovládacích prvků položek stromové struktury, a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu automatizace uživatelského rozhraní naleznete v tématu přehled stromu automatizace uživatelského rozhraní.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
|
|
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 založen na typu ovládacího prvku DataItem.
Sbalené stromové položky se nezobrazují v zobrazení ovládacího prvku nebo v zobrazení obsahu, dokud nebudou rozbalené a viditelné (nebo se dají 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 zobrazují v ovládacím prvku i v zobrazení obsahu stromu Automatizace uživatelského rozhraní a měly by mít vlastnost IUIAutomationElement::CurrentIsOffscreen (nebo CachedIsOffscreen) nastavena na TRUE.
Relevantní vlastnosti
Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro typ ovládacího prvku TreeItem. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Načítání vlastností z prvků automatizace uživatelského rozhraní.
| Vlastnost automatizace uživatelského rozhraní | Hodnota | Poznámky |
|---|---|---|
| UIA_AutomationIdPropertyId | Viz poznámky. | Hodnota této vlastnosti musí být jedinečná mezi všemi partnerskými prvky v nezpracovaného zobrazení stromu automatizace uživatelského rozhraní. |
| UIA_BoundingRectanglePropertyId | Viz poznámky. | Vnější obdélník, který obsahuje celý ovládací prvek. |
| UIA_ClickablePointPropertyId | Viz poznámky. | Tato vlastnost musí vrátit umístění, které způsobí, že položka stromu změní stav výběru nebo se zaměří. |
| UIA_ControlTypePropertyId | treeItem | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| UIA_IsContentElementPropertyId | TRUE | Ovládací prvek stromové položky je vždy součástí zobrazení obsahu stromu automatizace uživatelského rozhraní. |
| UIA_IsControlElementPropertyId | TRUE | Ovládací prvek stromové položky je vždy součástí zobrazení ovládacího prvku stromu automatizace uživatelského rozhraní. |
| UIA_IsKeyboardFocusablePropertyId | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. |
| UIA_IsOffscreenPropertyId | Viz poznámky. | Tato vlastnost označuje, zda je ovládací prvek stromové položky posunut mimo obrazovku. |
| UIA_ItemStatusPropertyId | Viz poznámky. | Pokud ovládací prvek obsahuje stav, který se dynamicky aktualizuje, musí být tato vlastnost podporována, aby technologie usnadnění může přijímat aktualizace, když se stav prvku změní. |
| UIA_ItemTypePropertyId | Viz poznámky. | Pokud ovládací prvek stromové položky používá ikonu vizuálu k označení, že je to určitý typ položky, musí být tato vlastnost podporována a musí indikovat typ položky. |
| UIA_LabeledByPropertyId | null | Ovládací prvky stromové položky jsou vlastní popisky. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající typu ovládacího prvku TreeItem. Výchozí hodnota je "stromová položka" pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | 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ů
Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které musí být podporovány všemi ovládacími prvky stromové položky. 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 |
|---|---|---|
| IExpandCollapseProvider | Požadovaný | Všechny položky stromové struktury musí podporovat ExpandCollapse vzor ovládacího prvku, protože všechny položky lze rozbalit nebo sbalit. |
| ExpandCollapseState | Rozbalený, sbalený nebo listový uzel | Položky stromu jsou uzly typu list, pokud nejsou rozbalené nebo sbalené. |
| IInvokeProvider | Závisí | Implementujte Vyvolat vzor ovládacího prvku, pokud stromová položka může provést příkaz. |
| IScrollItemProvider | Závisí | Implementujte vzor ovládacího prvku ScrollItem, pokud kontejner stromu podporuje vzor ovládacích prvků Scroll. |
| ISelectionItemProvider | Závisí | Implementujte vzor ovládacího prvku SelectionItem, pokud je možné mít aktivní výběr, který se zachová, když se uživatel vrátí do kontejneru stromu. |
| SelectionContainer | Požadovaný | Tato vlastnost zveřejňuje stejný kontejner pro všechny položky v kontejneru. |
Požadované události
Následující tabulka uvádí události automatizace uživatelského rozhraní, které ovládací prvky stromové položky vyžadují pro podporu. 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í | Poznámky |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId událost změněnou vlastností. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId událost změněnou vlastností. | |
| UIA_Invoke_InvokedEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku Invoke, musí tuto událost podporovat. |
| UIA_IsEnabledPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsEnabled, musí tuto událost podporovat. |
| UIA_IsOffscreenPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat. |
| UIA_ItemStatusPropertyId událost změny vlastnosti. | Pokud ovládací prvek podporuje vlastnost ItemStatus, musí tuto událost podporovat. |
| UIA_MultipleViewCurrentViewPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje MultipleView vzor ovládacího prvku, musí tuto událost podporovat. |
| UIA_NamePropertyId událost změněnou vlastností. | |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku SelectionItem, musí tuto událost podporovat. |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku SelectionItem, musí tuto událost podporovat. |
| UIA_SelectionItem_ElementSelectedEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku SelectionItem, musí tuto událost podporovat. |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Přepnout, musí tuto událost podporovat. |
| UIA_ValueValuePropertyId událost změny vlastnosti. | Pokud ovládací prvek podporuje vzor ovládacího prvku Hodnota, musí tuto událost podporovat. |
Poznámky
Pokud má položka stromu jiné než podřízené uzly osnovy, musí poskytovatel zpracovávat informace podřízeného objektu pečlivě a jasně. Ve službě Automatizace uživatelského rozhraní se struktura stromové struktury zpracovává samotnou hierarchií stromové struktury. Díky tomu, že jeden nebo více podřízených uzlů osnovy obsahuje rozdíly mezi nimi a skutečnými podřízenými uzly osnovy, jsou velmi nejednoznačné.
Související témata