Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku MenuBar
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 model UI Automation podpoře pro MenuBar typ ovládacího prvku. 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ů.
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 model UI Automation stromovou strukturu, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku MenuBar. Požadavky na model UI Automation platí pro všechny ovládací prvky seznamu, 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ů řádku nabídek, 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 |
|---|---|
| Menu - MenuItem (1 nebo více) - Jiné ovládací prvky (0 nebo mnoho) |
Menu - MenuItem (1 nebo více) - Jiné ovládací prvky (0 nebo mnoho) |
Ovládací prvky řádku nabídek můžou obsahovat další ovládací prvky, jako jsou úpravy ovládacích prvků 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.
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 řádku nabídek. Další informace o model UI Automation vlastnosti naleznete v tématu model UI Automation Vlastnosti pro klienty.
| vlastnost model UI Automation | Hodnota | Notes |
|---|---|---|
| BoundingRectangleProperty | Viz poznámky. | Hodnota vystavená touto vlastností musí obsahovat všechny ovládací prvky obsažené v této vlastnosti. |
| NameProperty | Viz poznámky. | Ovládací prvek řádku nabídek nepotřebuje název, pokud aplikace nemá více než jeden řádek nabídek. Pokud v aplikaci existuje více než jeden řádek nabídek, měla by se tato vlastnost použít k zveřejnění rozlišujícího názvů, například "Formátování" nebo "Osnova". |
| LabeledByProperty | Null |
Ovládací prvky řádku nabídek nikdy nemají popisek. |
| ControlTypeProperty | Menu | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| LocalizedControlTypeProperty | "řádek nabídek" | Lokalizovaný řetězec odpovídající typu ovládacího prvku MenuBar. |
| IsContentElementProperty | True | Ovládací prvek řádku nabídek je vždy součástí zobrazení obsahu model UI Automation stromu. |
| IsControlElementProperty | True | Ovládací prvek řádku nabídek je vždy součástí zobrazení ovládacího prvku stromu model UI Automation. |
| IsOffscreenProperty | Viz poznámky. | Hodnota této vlastnosti závisí na tom, zda je ovládací prvek zobrazitelný na obrazovce. |
| OrientationProperty | Závisí | Tato vlastnost zveřejňuje, zda je ovládací prvek řádku nabídek vodorovný nebo svislý. |
| IsKeyboardFocusableProperty | True | 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. |
| HelpTextProperty | Viz poznámky. | Pro ovládací prvek řádku nabídek nejsou vyžadovány žádné scénáře pro text nápovědy. |
| AcceleratorKeyProperty | Null |
Řádek nabídek nikdy nemá klávesy akcelerátoru. |
| AccessKeyProperty | "ALT" | Stisknutím klávesy ALT by se měl fokus vždy přesunout na řádek nabídek v aplikaci. |
Požadované vzory ovládacích prvků model UI Automation
V následující tabulce jsou uvedeny vzory ovládacích prvků model UI Automation, 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 model UI Automation Přehled vzorů ovládacích prvků.
| Vzor ovládacího prvku | Technická podpora | Notes |
|---|---|---|
| IExpandCollapseProvider | Závisí | Pokud lze ovládací prvek rozbalit nebo sbalit, implementujte IExpandCollapseProvider. |
| IDockProvider | Závisí | Pokud lze ovládací prvek ukotvit na různé části obrazovky, implementujte IDockProvider. |
| ITransformProvider | Závisí | Pokud lze změnit velikost ovládacího prvku, otočit nebo přesunout jej musí implementovat ITransformProvider. |
Požadované události model UI Automation
Následující tabulka uvádí model UI Automation události, které musí být podporovány všemi ovládacími prvky řádku nabídek. Další informace o událostech najdete v tématu model UI Automation Přehled událostí.
| událost model UI Automation | Podpora/hodnota | Notes |
|---|---|---|
| BoundingRectangleProperty událost změněná vlastností. | Požaduje se | Nic |
| IsOffscreenProperty událost změněná vlastností. | Požaduje se | Nic |
| IsEnabledProperty událost změněná vlastností. | Požaduje se | Nic |
| ExpandCollapseStateProperty událost změněná vlastností. | Závisí | Nic |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |