Typ ovládacího prvku MenuBar
Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku MenuBar.
Ovládací prvky řádku nabídek jsou příkladem ovládacích prvků, které implementují typ ovládacího prvku MenuBar. Řádku nabídek poskytují uživatelům způsob aktivace příkazů a možností obsažených 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 Menu Bar. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky řádku nabídek, 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í
- 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ů řádku nabídek 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í prvek řádku nabídek se vždy zobrazí v zobrazení ovládacího prvku, ale ne v zobrazení obsahu, protože obvykle nesděluje koncovému uživateli smysluplné informace (pokud aplikace neobsahuje více než jeden řádek nabídek).
Klienti automatizace uživatelského rozhraní mohou naslouchat události UIA_MenuModeStartEventId, aby se zajistilo, že jsou konzistentně upozorněni, když uživatelské rozhraní přejde do režimu nabídky. Když je aplikace v režimu nabídky, může být zaznamenán veškerý vstup klávesnice pro navigaci v nabídce (například zadáním znaku 's' může vyvolat Uložit nabídku místo psaní znaku v klientské oblasti aplikace). Událost UIA_MenuModeStartEventId musí předcházet první UIA_MenuOpenedEventId události, aby se zajistila logická konzistence. Událost UIA_MenuModeEndEventId následuje za poslední událostí UIA_MenuClosedEventId. Kliknutí na položku nabídky může také okamžitě aktivovat událost UIA_MenuModeStartEventId následovanou událostí UIA_MenuOpenedEventId.
Ovládací prvek řádku nabídek může obsahovat další ovládací prvky, například ovládací prvky pro úpravy a pole se seznamem v rámci struktury. Tyto další ovládací prvky odpovídají výše uvedeným ostatním ovládacím prvkům v zobrazení ovládacích prvků a obsahu.
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 MenuBar. 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_AcceleratorKeyPropertyId | NULA | Pruhy nabídek obvykle nemají klávesy akcelerátoru. |
| UIA_AccessKeyPropertyId | "ALT" | Stisknutím klávesy ALT by se obvykle mělo fokus přesunout na řádek nabídek v aplikaci. |
| UIA_BoundingRectanglePropertyId | Viz poznámky. | Hodnota vystavená touto vlastností musí obsahovat všechny ovládací prvky obsažené v této vlastnosti. |
| UIA_ControlTypePropertyId | řádku nabídek | |
| UIA_IsContentElementPropertyId | FALEŠNÝ | Ovládací prvek řádku nabídek není součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní. |
| UIA_IsControlElementPropertyId | PRAVDIVÝ | Ovládací prvek řádku nabídek je vždy součástí zobrazení ovládacího prvku stromu Automatizace uživatelského rozhraní. |
| UIA_IsKeyboardFocusablePropertyId | PRAVDIVÝ | Ovládací prvky řádku nabídek jsou fokus na klávesnici, protože ovládací prvky, které obsahují, můžou zabírat fokus klávesnice. |
| UIA_IsOffscreenPropertyId | Viz poznámky. | Hodnota této vlastnosti závisí na tom, zda je ovládací prvek zobrazitelný na obrazovce. |
| UIA_LabeledByPropertyId | NULA | Ovládací prvky řádku nabídek obvykle nemají popisek. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající MenuBar typ ovládacího prvku. Výchozí hodnota je "řádek nabídek" pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | Viz poznámky. | Ovládací prvek řádku nabídek nepotřebuje název, pokud aplikace nemá více než jeden řádek nabídek. Pokud je v aplikaci více než jeden řádek nabídek, použijte tuto vlastnost k zveřejnění rozlišující názvy, například "Formátování" nebo "Osnova". |
| UIA_OrientationPropertyId | Závisí | Tato vlastnost zveřejňuje, zda je ovládací prvek řádku nabídek vodorovný nebo svislý. |
Požadované vzory ovládacích prvků
V následující tabulce jsou uvedeny vzory ovládacích prvků automatizace uživatelského rozhraní, které jsou potřeba pro podporu ovládacích prvků řádku nabídek. 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 |
|---|---|---|
| IExpandCollapseProvider | Závisí | Pokud lze ovládací prvek rozbalit nebo sbalit, musí implementovat ExpandCollapse vzor ovládacího prvku. |
| IDockProvider | Závisí | Pokud lze ovládací prvek ukotvit na různé části obrazovky, musí implementovat Dock vzor ovládacího prvku. |
| ITransformProvider | Závisí | Pokud lze ovládací prvek změnit, otočit nebo přesunout, musí implementovat vzor ovládacího prvku Transformace. |
Požadované události
Následující tabulka uvádí události automatizace uživatelského rozhraní, které ovládací prvky řádku nabídek 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