Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku nabídka
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 podpoře microsoft model UI Automation pro typ ovládacího prvku Nabídky. Popisuje strukturu stromu Microsoft model 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 nabídky (například Soubor, Upravit a Okno) a každé tlačítko nabídky zobrazí nabídku. Nabídka obsahuje kolekci položek nabídky (například Nové, Otevřít a Zavřít), které lze rozbalit a zobrazit další položky nabídky nebo provést konkrétní akci po kliknutí.
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 Nabídky. 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 model UI Automation stromu, 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 model UI Automation naleznete v tématu model UI Automation Strom přehledu.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
| Nabídka - MenuItem (1 nebo n) |
Nelze použít (pokud ovládací prvek nabídky není místní nabídka, která je nadřazeným objektem, který není položkou nabídky). - MenuItem (1 nebo n) |
Ovládací prvky nabídky se vždy zobrazují v zobrazení ovládacího prvku a v zobrazení obsahu model UI Automation stromu. Typy ovládacích prvků nabídky by se měly zobrazit pod ovládacím prvku, na který odkazují jejich informace. model UI Automation klienti musí naslouchatMenuOpenedEvent, 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. Zobrazují se jako podřízené položky desktopu.
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 typ ovládacího prvku Nabídka. Další informace o model UI Automation vlastnosti naleznete v tématu model UI Automation Vlastnosti pro klienty.
| vlastnost model UI Automation | Hodnota | Notes |
|---|---|---|
| NameProperty | Nepodporuje se | 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 | Nabídka | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| IsContentElementProperty | False | Ovládací prvek nabídky není součástí zobrazení obsahu stromu model UI Automation. |
| IsControlElementProperty | True | Ovládací prvek nabídky je vždy součástí ovládacího prvku strom model UI Automation. |
Požadované vzory ovládacích prvků model UI Automation
Pro typ ovládacího prvku Nabídky nejsou vyžadovány žádné vzory ovládacích prvků.
Požadované události model UI Automation
Ovládací prvky nabídky se musí zvýšit MenuOpenedEvent , když se zobrazí na obrazovce. Bude MenuOpenedEvent obsahovat text ovládacího prvku. Musí MenuClosedEvent být vyvolána, když nabídka zmizí z obrazovky.
Následující tabulka uvádí model UI Automation události, které musí být podporovány všemi ovládacími prvky nabídky. Další informace o událostech najdete v tématu model UI Automation Přehled událostí.
| událost model UI Automation | Podpora/hodnota | Notes |
|---|---|---|
| MenuOpenedEvent | Požaduje se | Nic |
| MenuClosedEvent | Požaduje se | Nic |
| 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 |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |