com.teamdev.jxbrowser.search

Interface TextFinder

public interface TextFinder

Allows finding text on the loaded web page.

Method Summary

Modifier and Type	Method and Description
void	find(java.lang.String text, java.util.function.Consumer<FindResult> onFindResult) Performs search of the given text, highlights all matches and selects the first match on the currently loaded web page.
void	find(java.lang.String text, FindOptions options, java.util.function.Consumer<FindResult> onFindResult) Performs search of the given text with the given options, highlights all matches and selects the first match on the currently loaded web page.
void	stopFindingAndClearSelection() Stops finding and clears the highlighting of the found matches.
void	stopFindingAndKeepSelection() Stops finding and keeps the the currently highlighted match selected.

Method Detail

find

void find(java.lang.String text,
          java.util.function.Consumer<FindResult> onFindResult)

Performs search of the given text, highlights all matches and selects the first match on the currently loaded web page.

The search is performed only through a visible content on the loaded web page. If some text is presented on the web page, but due to CSS rules it is not visible, the text finder will not check this content during search. Also, it does not find text on the web pages with an empty size, so make sure that the size of the browser instance where the text search is performed isn't empty.

Parameters:

text - a text to search

onFindResult - a consumer object which allows obtaining the search result

Throws:

java.lang.IllegalArgumentException - when text is empty or blank

java.lang.IllegalStateException - when the browser is closed

find

void find(java.lang.String text,
          FindOptions options,
          java.util.function.Consumer<FindResult> onFindResult)

Performs search of the given text with the given options, highlights all matches and selects the first match on the currently loaded web page.

The search is performed only through a visible content on the loaded web page. If some text is presented on the web page, but due to CSS rules it is not visible, the text finder will not check this content during search. Also, it does not find text on the web pages with an empty size, so make sure that the size of the browser instance where the text search is performed isn't empty.

Parameters:

text - a text to search

options - the parameters such as direction and match case

onFindResult - a consumer object which allows obtaining the search result

Throws:

java.lang.IllegalArgumentException - when text is empty

java.lang.IllegalStateException - when the browser is closed

stopFindingAndKeepSelection

void stopFindingAndKeepSelection()

Stops finding and keeps the the currently highlighted match selected.

Throws:

java.lang.IllegalStateException - when the browser is closed

stopFindingAndClearSelection

void stopFindingAndClearSelection()

Stops finding and clears the highlighting of the found matches.

Throws:

java.lang.IllegalStateException - when the browser is closed