GetTextBackgroundColor

Syntax

string GetTextBackgroundColor (string drawfunction, string text, int index)

Retrieve color code of the text background residing in a given control, in hexadecimal.

drawfunction
TestArchitect detects the text fragment drawn by its 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.
text
String representing the bitmap text fragment to be searched for.
index
Specifies a minimum number of instances of the search text that must be discovered within the active area for the target bitmap text fragment to be considered as found (default = 1).

A hexadecimal value indicating color code of the text background.

This method always employs the Graphics Device Interface (GDI) technique to recognize text produced by an AUT.
You can also apply GDI methods including:
To reconstruct a table from the recognized texts. Note that, off-screen columns/rows will not be counted. This circumstance is quite useful when you’d like to retrieve a number of columns/rows in a table by using GDI technique.
Technically, the GDI methods reconstruct columns based on the vertical bar’s max height in the given control. By default, when a detected vertical bar is equivalent to or above 80% of the max vertical bar, this detected vertical bar is a separator of a column. If the reconstructed number of column is not what you expect, adjusting the value of the gdi column identifier percentage built-in setting might help.
Similarly, rows are reconstructed based on the horizontal bar’s max height. By default, when a detected horizontal bar is equivalent to or above 80% of the max horizontal bar, the detected horizontal bar is a separator of a row. gdi row identifier percentage is the built-in setting to define the threshold value for reconstructing rows.