Typ ovládacího prvku ToolBar
Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku ToolBar. Ovládací prvky panelu nástrojů umožňují koncovým uživatelům aktivovat příkazy a nástroje obsažené v aplikaci.
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 Tool Bar. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky panelu nástrojů, ve kterých architektura uživatelského rozhraní nebo platforma integrují 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í
- 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ů panelu nástrojů a popisuje, co může být obsaženo v každém zobrazení. 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í prvek panelu nástrojů může obsahovat libovolný typ ovládacího prvku v jeho podstromu. Nejčastěji obsahují tlačítka, pole se seznamem a dělená tlačítka.
Relevantní vlastnosti
Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro ToolBar typ ovládacího prvku. 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. | Podporuje se, pokud existuje ohraničující obdélník. Pokud ne každý bod uvnitř ohraničujícího obdélníku je možné kliknout a prvek provádí specializované testování hitů, přepište a poskytněte kliknutelný bod. |
| UIA_ControlTypePropertyId | ToolBar | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| UIA_IsContentElementPropertyId | PRAVDIVÝ | Ovládací prvek panelu nástrojů je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní. |
| UIA_IsControlElementPropertyId | PRAVDIVÝ | Ovládací prvek panelu nástrojů 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_LabeledByPropertyId | NULA | Ovládací prvek panelu nástrojů nikdy nemá popisek. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající ToolBar typ ovládacího prvku. Výchozí hodnota je "panel nástrojů" pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | Závisí | Ovládací prvek panelu nástrojů nepotřebuje název, pokud není v aplikaci použito více než jeden. Pokud existuje více než jeden, musí mít každý rozlišující název (například "Formátování" nebo "Osnova"). |
Požadované vzory ovládacích prvků
V následující tabulce jsou uvedeny vzory ovládacích prvků automatizace uživatelského rozhraní vyžadované k podpoře ovládacími prvky panelu nástrojů. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.
| Vzor ovládacího prvku | Podpora | Poznámky |
|---|---|---|
| IDockProvider | Závisí | Pokud lze panel nástrojů ukotvit na různé části obrazovky, musí podporovat řídicí vzor Docku. |
| IExpandCollapseProvider | Závisí | Pokud je možné panel nástrojů rozbalit a sbalit, aby se zobrazily další položky, musí podporovat ExpandCollapse vzor ovládacího prvku. |
| ITransformProvider | Závisí | Pokud je možné změnit velikost, otočit nebo přesunout panel nástrojů, musí podporovat vzor ovládacích prvků Transformace. |
Požadované události
Následující tabulka uvádí události automatizace uživatelského rozhraní, které ovládací prvky panelu nástrojů 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í. | Pokud ovládací prvek podporuje ExpandCollapse vzor ovládacího prvku, 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_StructureChangedEventId |
Související témata