Automation Guide Action-based testing language Built-in actions User Interface actions Control, Element

 is control focused

is control focused

Description

Return a Boolean value to indicate whether the specified control has focus.

Arguments

• window

  TA name of the window.

• control

  TA name of the control.

• variable

  (Optional) Variable to receive the returned Boolean value.

  Possible returned values:

  • 1

    Control has focus.

  • 0

    Control does not have focus.

Valid contexts

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

Notes

• variable argument:
  • If the variable in argumentvariablehas not been declared, the action creates it as a global.
  • If the variable argument 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, page wait, object wait, window wait.

Applicable Controls

This action is applicable to the following controls: button, check box, checklist, combo box, datetime, list box, menu, password, radio button, richtext, separator, spin, tab control, table, text box, toggle button, toolbar, trackbar, tree view.

Example

Action Lines

Result

Related information

focus control