find_text_with_options

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.

Parameters:

this	a Page
text	the text to search for (UTF-8 encoded)
options	find options

Returns:

a newly allocated list of newly allocated Rectangle. Free with g_list_free_full using free.