Automation Guide Action-based testing language Built-in actions User Interface actions Toolbar, Menu, Scrollbar

 does button menu exist

does button menu exist

Description

Return a Boolean value to indicate whether a specified menu item of a button drop-down control is found to exist.

Arguments

• window

  TA name of the window.

• control

  TA name of the button control.

• item

  Menu item or menu item path (see Notes).

• output

  (Optional) Variable to receive the returned Boolean value.

  Possible returned values:

  • 1

    Item found.

  • 0

    Item not found.

Valid contexts

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

Notes

• item argument: 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.
• output argument:
  • If the variable in argumentoutputhas not been declared, the action creates it as a global.
  • If the outputargument is left empty, TestArchitect supplies a global variable with the name _result.
• 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, object wait, window wait, load invisible controls.

Applicable Controls

This action is applicable to the following controls: menu.

Example

Action Lines

Result

Related information

check button menu exists

check button menu not exists