GetTextBackgroundColor

Syntax

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

Retrieve color code of the text background residing in a given window, 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 is currently supported only by the C# harness.
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.