GetTextCoordinates

Syntax

TARect GetTextCoordinates (string text, TARect rect, int index, string color)

Return the location and dimensions of an instance of a specified bitmap text fragment within the object’s bitmap.

text
String representing the bitmap text fragment whose presence the object’s bitmap will be scanned for.
rect
TARect value specifying a rectangular active area in the object’s bitmap. Scanning for the matching bitmap text fragment is limited to this active area.
index
Index of the specific instance of the matching bitmap text fragment of interest, in case more than one is discovered within the active area.
Note that index numbering begins with 1. (Default: 1)
color
Color code of the text, in hexadecimal.

A TARect object is returned, representing the bounding rectangle of the found bitmap text fragment of interest, and containing the following:
- left: Horizontal coordinate of left border of the bounding rectangle relative to the left side of the calling object.
- top: Vertical coordinate of top of the bounding rectangle relative to the top of the calling object.
- width: Width of the bounding rectangle.
- height: Height of the bounding rectangle.
If the index-specified instance of the bitmap text fragment is not found, return null.

As an AbtImageProcessor object represents the entire display; the returned left and top coordinates are relative to the left and top of screen, respectively.
This method is currently supported only by the C# harness.