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

 check toolbar menu state

check toolbar menu state

Description

Check, against an expected value, the state of an item on a drop-down menu hosted by a toolbar button (that is, a drop-down menu that appears when user clicks a button on a toolbar). Result is Passed ifthe values match; otherwise Failed.

Arguments

• window

  TA name of the window.

• toolbar

  TA name of the toolbar control.

• button

  Button, as identified by its captionor index value.

• item

  Menu item or menu item path (see Notes).

• expected

  Expected value(s) of the menu item.

  Possible values:

  • disabled

    The menu item is unavailable or disabled.

  • enabled

    The menu item is enabled or available.

  • checked

    The menu item is selected.

  Tip: 
  Use commas (,) as delimiters between expected values of the state property.

Valid contexts

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

Notes

• 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, ignore blank space, remove double quotes from cells, standard ASCII only, item wait, object wait, value changed wait, window wait, load invisible controls.

Applicable Controls

This action is applicable to the following controls: toolbar

Example

Action Lines

Result