UI Actions › Actions › Select Menu Item
Tries to find the UI menu element, and trigger it. If the element is a menu or submenu, that will open the menu. If the element is a menu item, its related function will be called.
On success, it returns a menu item reference which can be used as input in other menu actions of UI Actions.
The action will raise an error if the requested menu item couldn’t be found.
Parameters
App
Select the app which the menu belongs to.
Type: An app from a pre-defined list of available apps
Targeting options
You can look up a menu item or sub menu by either …
- its title, e.g.
Contacts… - its path, e.g.
Edit > AutoFill > Contacts… - its segmented path, e.g.
Edit,AutoFill,Contacts… - its reference, i.e. a menu item returned by another Shortcuts action.
A menu path is a single string containing the path segments separated by ”>“.
Leading and trailing whitespace in segments is stripped. The lookup deals gracefully with segments ending in either an ellipses or triple dots, if either variant exists in the menu structure, it’ll be found.
Options:
- title
- path
- segmented path
- reference
Optional Menu item title
The menu item label as it occurs in the actual menu. Depending on the selected filter criteria, a partial title might be enough.
Type: Text
Title filter criteria
Only available when searching by title.
Options:
- is
- contains
- begins with
- ends with
- matches regular expression
Case-insensitive filtering
Enable if lowercase and uppercase shouldn’t make a difference. Only available when searching by title or path.
Type: Boolean (YES/NO)
Optional Menu item path
The menu item’s hierarchical path, starting at the main menu, separated by ”>” characters, e.g. View > Translation > Translate to German.
Type: Text
Optional Main menu title
The first segment of a menu item’s path, e.g. View or Edit etc.
Type: Text
Optional Sub-menu or item #1
The next segment of the menu item’s path.
Type: Text
Optional Sub-menu or item #2
The next segment of the menu item’s path.
Type: Text
Optional Sub-menu or item #3
The next segment of the menu item’s path.
Type: Text
Optional Sub-menu or item #4
The next segment of the menu item’s path.
Type: Text
Optional Menu item reference
The result of another menu action of UI Actions, i.e. a static Menu Item snapshot.
Type: Menu Item reference
Pause after selecting
This adds a short pause after selecting the menu item.
Options:
- no pause
- 0.2 secs
- 0.5 secs
- 1.0 secs
- 1.5 secs
- 2.0 secs
- 3.0 secs
- 4.0 secs
Return Value
Related Links
- Search the UI Actions community forum for "Select Menu Item"