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 poppler_find_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 poppler_rectangle_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, poppler_rectangle_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 poppler_find_backwards and poppler_find_multiline together, poppler_find_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.