Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku nabídky

Poznámka:

Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy automatizace uživatelského rozhraní definované v oboru názvů System.Windows.Automation. Nejnovější informace o automatizaci uživatelského rozhraní najdete v tématu rozhraní API služby Windows Automation: Automatizace uživatelského rozhraní.

Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní Microsoftu pro typ ovládacího prvku Nabídky. Popisuje strukturu stromu Microsoft UI Automation ovládacího prvku a poskytuje vlastnosti a vzory ovládacích prvků pro konkrétní scénáře řízení.

Ovládací prvek nabídky umožňuje hierarchii prvků spojených s příkazy a obslužnými rutinami událostí. V typické aplikaci Microsoft Windows obsahuje řádek nabídek několik tlačítek (například Soubor, Upravita Okno) a každé tlačítko nabídky zobrazí nabídku. Nabídka obsahuje kolekci položek nabídky (například Nový, Otevříta Zavřít), které lze rozbalit tak, aby zobrazovaly další položky nabídky nebo prováděly konkrétní akci po kliknutí.

Následující části definují požadovanou strukturu automatizovaného uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro ovládací prvek Nabídky. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky seznamu, ať už windows Presentation Foundation (WPF), Win32 nebo Windows Forms.

Požadovaná struktura stromu automatizace uživatelského rozhraní

Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacích prvků 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í najdete v tématu Přehled stromu automatizace uživatelského rozhraní.

Zobrazení ovládacího prvku	Zobrazení obsahu
Jídelní lístek - MenuItem (1 nebo n)	Nelze použít (pokud ovládací prvek nabídky je místní nabídka, která je nadřazeným objektem, nikoli položkou nabídky). - MenuItem (1 nebo n)

Ovládací prvky nabídky se vždy zobrazí v zobrazení ovládacího prvku a v zobrazení obsahu stromu automatizace uživatelského rozhraní. Typy ovládacích prvků nabídky by se měly zobrazit pod ovládacím prvku, na který odkazují jejich informace. Klienti automatizace uživatelského rozhraní musí naslouchat MenuOpenedEvent, aby zajistili, že získávají konzistentně informace předávané ovládacími prvky nabídky. Ovládací prvky místní nabídky jsou zvláštním případem. Zobrazují se jako podřízené položky desktopu.

Požadované vlastnosti automatizace uživatelského rozhraní

Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště důležité pro ovládací prvek typu Nabídka. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Vlastnosti automatizace uživatelského rozhraní pro klienty.

Vlastnost automatizace uživatelského rozhraní	Hodnota	Poznámky
NameProperty	Nepodporováno	Ovládací prvek nabídky nevyžaduje, aby byla nastavena vlastnost Name.
LabeledByProperty	Null	U typického ovládacího prvku nabídky se nepředpokládá žádný popisek.
ControlTypeProperty	Jídelní lístek	Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
IsContentElementProperty	Nepravda	Ovládací prvek nabídky není zahrnut v zobrazení obsahu stromu automatizace uživatelského rozhraní.
IsControlElementProperty	Pravdivé	Ovládací prvek nabídky je vždy součástí zobrazení ovládacího prvku stromu automatizace uživatelského rozhraní.

Požadované vzory ovládacích prvků automatizace uživatelského rozhraní

Pro typ ovládacího prvku Nabídky nejsou vyžadovány žádné vzory ovládacích prvků.

Požadované události automatizace uživatelského rozhraní

Ovládací prvky nabídky musí vyvolat MenuOpenedEvent , když se zobrazí na obrazovce. Text ovládacího prvku bude zahrnut ve MenuOpenedEvent. Musí MenuClosedEvent být vyvolán, když nabídka zmizí z obrazovky.

Následující tabulka uvádí události automatizace uživatelského rozhraní, které musí podporovat všechny ovládací prvky nabídky. 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í	Podpora/hodnota	Poznámky
MenuOpenedEvent	Povinné	Žádné
MenuClosedEvent	Povinné	Žádné
BoundingRectangleProperty událost změny vlastnosti.	Povinné	Žádné
IsOffscreenProperty událost změny vlastnosti.	Povinné	Žádné
IsEnabledProperty událost změny vlastnosti.	Povinné	Žádné
AutomationFocusChangedEvent	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné

Viz také

• Menu
• Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní
• Přehled typů ovládacích prvků automatizace uživatelského rozhraní
• Přehled automatizace uživatelského rozhraní