check button menu exists


Check for the existence of a menu item of a button drop-down. Result is Passed if the specified item is found; otherwise Failed.
Note: The drop-down button consists of a button. When clicked, the button displays a drop-down menu or list of items.


TA name of the window.
TA name of the button control.
Menu item or menu item path (see Notes).

Valid contexts

This action may be used within the following project items: test modules and user-defined actions.


  • item argument:
    • Menu items are identified by their caption properties.
    • If a menu path of more than one item must be specified, use arrow symbols ( -> ) as delimiters between menu items. For example, Vehicles->Cars->Four-door sedans.
  • This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.

Applicable Built-In Settings

The following settings are applicable to this action: case sensitive, remove double quotes from cells, standard ASCII only, item wait, object wait, window wait, load invisible controls.

Applicable Controls

This action is applicable to the following controls: menu.


Action Lines