GetTextCount
Syntax
int getTextCount (string drawfunction, string text)
Description
Retrieve a count of the total number of text fragments residing in a given window.
Parameters
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).
注意:- 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.
Return Value
An integer value indicating the total number of text fragments found.
Notes
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.