Finds text
in this with the given FindFlags
options and returns a List of rectangles for each occurrence of the text on the page.
The coordinates are in PDF points.
When MULTILINE is passed in options
, matches may span more
than one line. In this case, the returned list will contain one Rectangle for each
part of a match. The function find_get_match_continued will
return true
for all rectangles belonging to the same match, except for the last one. If a hyphen was ignored at the end of
the part of the match, find_get_ignored_hyphen will return
true
for that rectangle.
Note that currently matches spanning more than two lines are not found. (This limitation may be lifted in a future version.)
Note also that currently finding multi-line matches backwards is not implemented; if you pass BACKWARDS and MULTILINE together, MULTILINE will be ignored.
this |
a Page |
text |
the text to search for (UTF-8 encoded) |
options |
find options |
a newly allocated list of newly allocated Rectangle. Free with |