Pop-up Menu (MSAA UI Element Reference)
Note
This topic describes Pop-up Menu objects for purposes of MSAA UI Element Reference. How to create Pop-up Menu objects in various UI frameworks is not described here. See the API reference documentation for the UI framework you're using.
A pop-up menu displays a list of menu commands. Microsoft Active Accessibility creates a menu pop-up object when a menu item in a menu bar is opened. Microsoft Active Accessibility also creates menu pop-up objects for context menus, which are displayed when the user right-clicks a user interface element.
The window class name for a pop-up menu is "#32768".
IAccessible Methods
A pop-up menu supports the following IAccessible methods:
IAccessible Properties
A pop-up menu supports the following IAccessible properties:
| Property | Comments |
|---|---|
| get_accChild | Retrieves the IDispatch for the specified menu item. The child IDs for the menu items are numbered sequentially from top to bottom starting with one. |
| get_accChildCount | The ChildCount property is the number of menu items in the menu, including menu separators. |
| get_accFocus | |
| get_accName | The Name property for a pop-up menu is the same name as the menu. The Name property for a context menu is "Context". |
| get_accParent | The Parent property is a window ( ROLE_SYSTEM_WINDOW ) that surrounds the pop-up menu and has the same Name property and window class name as the pop-up menu . |
| get_accRole | The Role property is ROLE_SYSTEM_MENUPOPUP. |
| get_accState | The State property is a combination of one or more of the following values: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE |
Notes
- Pop-up menu objects do not trigger EVENT_OBJECT_CREATE and EVENT_OBJECT_DESTROY events.
- Multi-column menus do not support the NAVDIR_LEFT or NAVDIR_RIGHT flags of the accNavigate method.
- The events EVENT_SYSTEM_MENUPOPUPSTART and EVENT_SYSTEM_MENUPOPUPEND are not sent consistently. This is a known issue and is being addressed.