Automation Guide Action-based testing language Built-in actions User Interface actions Optical Character Recognition

 get text content

get text content

Description

Retrieve all content of the text fragment residing in a given window/control.

Arguments

• window

  TA name of the window.

• control

  (Optional) TA name of the control.

• drawing function

  (Optional) TestArchitect detects the text fragment drawn by several drawing functions.

  Allowable values:

  • DrawTextA: Retrieve texts drawn by the DrawTextA function (ANSI name).

  • DrawTextW: Retrieve texts drawn by the DrawTextW function (Unicode name).

  • TextOutA: Retrieve texts drawn by the TextOutA function (ANSI name).

  • TextOutW: Retrieve texts drawn by the TextOutA function (Unicode name).

  • ExtTextOutA: Retrieve texts drawn by the ExtTextOutA function (ANSI name).

  • ExtTextOutW: Retrieve texts drawn by the ExtTextOutW function (Unicode name).

    Note:

  • If the argument’s value is omitted, by default, TestArchitect retrieve texts drawn by all drawing functions above.

  • To use multiple values at a time, use semi-colon ( ; ) as delimiters between values.

• variable

  (Optional) Variable to receive the returned value.

Valid contexts

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

Applicable Systems/Platforms

Use of this action is supported on the following systems/platforms:

• Windows: Win32, WinForms.

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.

Notes

• This built-in action always employs the Graphics Device Interface (GDI) technique. In other words, Optical Character Recognition (OCR) technique is not available for this action.
• drawing function argument:
  • By default, when the argument’s value is omitted, this built-in action automatically employs all available drawing functions. This might significantly cause a performance issue, since every drawing function will be in turn verified.
  • To determine which exact drawing functions should be employed to enhance automation performance, use the Text Recognition feature available in the Interface Viewer. (Learn more.)
• 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.

Example

Action Lines

Result

From the result, we can see that the Administration text is drawn by two functions including ExtTextOutA and ExtTextOutW.