Sets the new search context for the document.
Use this function only when the search occurrences are highlighted. So this function should not be used for background searches. The purpose is to have only one highlighted search context at a time in the document.
After using this function, you should unref the search_context
. The this should be the
only owner of the search_context
, so that the Clear Highlight action works. If you need the search_context
after
calling this function, use get_search_context.
this |
a Document |
search_context |
the new SourceSearchContext |