1.6

Table Of Contents
Examples
To search the word "text" on a 8 1/2 x 11 page, the syntax is:
data.find("text", 0, 216);
Numbers 0 and 216 are in millimeters and indicate the left and right limits (constraints) within
which the search should be. Values (0, 216) in this example represent the entire width of a
page. Note that the smaller the area is, the faster the search is. So if you know that the word
"text" is within 3 inches from the left edge of the page, provide the following:
data.find("text", 0, 76.2); 76.2mm = 3*25.4 mm
The return value of the function is:
[Left=26,76, Top=149.77, Right=40,700001, Bottom=154.840302]
Which represents the size of the imaginary rectangle that encloses the string in full, in
millimeters relative to the upper left corner of the current page. This also means that the
data.find() function only works on the current page. If the record contains several pages, you
must create a loop that will perform a jump from one page to another by making a find() on each
page.
findRegExp()
Finds the first match for regular expression pattern regexpToFind starting from the current
position. Regular expression flags (i,s,L,m,u,U,d) are specified in the flags parameter (see
online documentation for more information on each flag). The search can be constrained to a
vertical column of characters located between leftConstraint and rightConstraint, each
expressed in characters. The method returns null if regexpToFind produces no match,
otherwise it returns a RectValueText object.
The RectValueText object contains the Left, Top, Right and Bottom coordinates - expressed
in characters and relative to the upper left corner of the current page - of the smallest possible
rectangle that completely encloses the first match for regexpToFind.
Note that partial matches are not allowed, i.e. the entire match for regexpToFind must be found
between the leftConstraint and rightConstraint values. Note also that calling this method
does not move the current position to the location where the match occurred, allowing you to
use the method as a look-ahead function without disrupting the rest of the workflow.
Page 253