Sdílet prostřednictvím


Typ ovládacího prvku nabídky

Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní microsoftu pro typ ovládacího prvku Menu.

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 stromu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Menu. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky 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á 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ů nabídky 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
  • Menu
    • MenuItem (1 nebo mnoho)
    • Jiné ovládací prvky (0 nebo mnoho)
  • Menu
    • MenuItem (1 nebo mnoho)
    • Jiné ovládací prvky (0 nebo mnoho)

 

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í. Ovládací prvky nabídky by se měly zobrazit pod ovládacím prvku, na který odkazují jejich informace. Klienti automatizace uživatelského rozhraní mohou naslouchat UIA_MenuOpenedEventId, aby zajistili, že konzistentně získávají informace předávané ovládacími prvky nabídky. Ovládací prvky místní nabídky jsou zvláštním případem. Můžou se zobrazit jako podřízené položky plochy nebo okna aplikace nejvyšší úrovně.

Ovládací prvek nabídky může obsahovat další ovládací prvky, například upravit ovládací prvky a pole se seznamem v rámci struktury. Tyto další ovládací prvky odpovídají "ostatním ovládacím prvkům" uvedeným v předchozí tabulce 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 nabídky . 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_ControlTypePropertyId nabídky
UIA_IsContentElementPropertyId PRAVDIVÝ Ovládací prvek nabídky je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní.
UIA_IsControlElementPropertyId PRAVDIVÝ Ovládací prvek nabídky je vždy součástí zobrazení ovládacího prvku stromu automatizace uživatelského rozhraní.
UIA_LabeledByPropertyId NULA U typického ovládacího prvku nabídky se nepředpokládá žádný popisek.
UIA_NamePropertyId Viz poznámky. Ovládací prvek nabídky nevyžaduje nastavení vlastnosti Název nebo může mít stejný název jako přidružený ovládací prvek, například položku nabídky, která otevřela podnabídku.

 

Požadované vzory ovládacích prvků

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

Požadované události

Ovládací prvky nabídky musí vyvolat událost UIA_MenuOpenedEventId, když se zobrazí na obrazovce. Událost UIA_MenuOpenedEventId bude obsahovat text ovládacího prvku. Událost UIA_MenuClosedEventId musí být vyvolána, když nabídka zmizí z obrazovky.

V následující tabulce jsou uvedeny události automatizace uživatelského rozhraní, které ovládací prvky nabídky 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_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_MenuClosedEventId
UIA_MenuOpenedEventId
UIA_StructureChangedEventId

 

koncepční

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

Přehled automatizace uživatelského rozhraní