Class FindController

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.webkitgtk.FindController

All Implemented Interfaces:

Proxy

@Generated("org.javagi.JavaGI")
public final class FindController
extends GObject

Controls text search in a WebKitWebView.

A WebKitFindController is used to search text in a WebKitWebView. You can get a WebKitWebView's WebKitFindController with webkit_web_view_get_find_controller(), and later use it to search for text using webkit_find_controller_search(), or get the number of matches using webkit_find_controller_count_matches(). The operations are asynchronous and trigger signals when ready, such as WebKitFindController::found-text, WebKitFindController::failed-to-find-text or WebKitFindController::counted-matches.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	FindController.Builder<B extends FindController.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static interface	FindController.CountedMatchesCallback	Functional interface declaration of the CountedMatchesCallback callback.
static interface	FindController.FailedToFindTextCallback	Functional interface declaration of the FailedToFindTextCallback callback.
static class	FindController.FindControllerClass
static interface	FindController.FoundTextCallback	Functional interface declaration of the FoundTextCallback callback.

Nested classes/interfaces inherited from class GObject

GObject.NotifyCallback, GObject.ObjectClass

Constructor Summary

Constructors

Constructor	Description
FindController()	Create a new FindController.
FindController(MemorySegment address)	Create a FindController instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
protected FindController	asParent()	Return this instance as if it were its parent type.
static FindController.Builder<? extends FindController.Builder>	builder()	A FindController.Builder object constructs a FindController with the specified properties.
void	countMatches(String searchText, int findOptions, int maxMatchCount)	Counts the number of matches for searchText.
void	emitCountedMatches(int matchCount)	Emits the "counted-matches" signal.
void	emitFailedToFindText()	Emits the "failed-to-find-text" signal.
void	emitFoundText(int matchCount)	Emits the "found-text" signal.
int	getMaxMatchCount()	Gets the maximum number of matches to report.
static MemoryLayout	getMemoryLayout()	The memory layout of the native struct.
int	getOptions()	Gets the WebKitFindOptions for the current search.
String	getSearchText()	Gets the text that this FindController is searching for.
static @Nullable Type	getType()	Get the GType of the FindController class.
WebView	getWebView()	Gets the WebKitWebView this find controller is associated to.
SignalConnection<FindController.CountedMatchesCallback>	onCountedMatches(FindController.CountedMatchesCallback handler)	This signal is emitted when the WebKitFindController has counted the number of matches for a given text after a call to webkit_find_controller_count_matches().
SignalConnection<FindController.FailedToFindTextCallback>	onFailedToFindText(FindController.FailedToFindTextCallback handler)	This signal is emitted when a search operation does not find any result for the given text.
SignalConnection<FindController.FoundTextCallback>	onFoundText(FindController.FoundTextCallback handler)	This signal is emitted when a given text is found in the web page text.
void	search(String searchText, int findOptions, int maxMatchCount)	Looks for searchText associated with findController.
void	searchFinish()	Finishes a find operation.
void	searchNext()	Looks for the next occurrence of the search text.
void	searchPrevious()	Looks for the previous occurrence of the search text.

Methods inherited from class GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class ProxyInstance

equals, handle, hashCode

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

FindController

public FindController(MemorySegment address)

Create a FindController instance for the provided memory address.

Parameters:

address - the memory address of the native object

FindController

public FindController()

Create a new FindController.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the FindController class.

Returns:

the GType

getMemoryLayout

public static MemoryLayout getMemoryLayout()

The memory layout of the native struct.

Returns:

the memory layout

asParent

protected FindController asParent()

Return this instance as if it were its parent type. Comparable to the Java super keyword, but ensures the parent typeclass is also used in native code.

Overrides:

asParent in class GObject

Returns:

the instance as if it were its parent type

countMatches

public void countMatches(String searchText,
 int findOptions,
 int maxMatchCount)

Counts the number of matches for searchText.

Counts the number of matches for searchText found in the WebKitWebView with the provided findOptions. The number of matches will be provided by the WebKitFindController::counted-matches signal.

Parameters:

searchText - the text to look for

findOptions - a bitmask with the WebKitFindOptions used in the search

maxMatchCount - the maximum number of matches allowed in the search

getMaxMatchCount

public int getMaxMatchCount()

Gets the maximum number of matches to report.

Gets the maximum number of matches to report during a text lookup. This number is passed as the last argument of webkit_find_controller_search() or webkit_find_controller_count_matches().

Returns:

the maximum number of matches to report.

getOptions

public int getOptions()

Gets the WebKitFindOptions for the current search.

Gets a bitmask containing the WebKitFindOptions associated with the current search.

Returns:

a bitmask containing the WebKitFindOptions associated with the current search.

getSearchText

public String getSearchText()

Gets the text that this FindController is searching for.

Gets the text that this FindController is currently searching for. This text is passed to either webkit_find_controller_search() or webkit_find_controller_count_matches().

Returns:

the text to look for in the WebKitWebView.

getWebView

public WebView getWebView()

Gets the WebKitWebView this find controller is associated to.

Do not dereference the returned instance as it belongs to the WebKitFindController.

Returns:

the WebKitWebView.

search

public void search(String searchText,
 int findOptions,
 int maxMatchCount)

Looks for searchText associated with findController.

Looks for searchText in the WebKitWebView associated with this FindController since the beginning of the document highlighting up to maxMatchCount matches. The outcome of the search will be asynchronously provided by the WebKitFindController::found-text and WebKitFindController::failed-to-find-text signals.

To look for the next or previous occurrences of the same text with the same find options use webkit_find_controller_search_next() and/or webkit_find_controller_search_previous(). The WebKitFindController will use the same text and options for the following searches unless they are modified by another call to this method.

Note that if the number of matches is higher than maxMatchCount then WebKitFindController::found-text will report G_MAXUINT matches instead of the actual number.

Callers should call webkit_find_controller_search_finish() to finish the current search operation.

Parameters:

searchText - the text to look for

findOptions - a bitmask with the WebKitFindOptions used in the search

maxMatchCount - the maximum number of matches allowed in the search

searchFinish

public void searchFinish()

Finishes a find operation.

Finishes a find operation started by webkit_find_controller_search(). It will basically unhighlight every text match found.

This method will be typically called when the search UI is closed/hidden by the client application.

searchNext

public void searchNext()

Looks for the next occurrence of the search text.

Calling this method before webkit_find_controller_search() or webkit_find_controller_count_matches() is a programming error.

searchPrevious

public void searchPrevious()

Looks for the previous occurrence of the search text.

Calling this method before webkit_find_controller_search() or webkit_find_controller_count_matches() is a programming error.

onCountedMatches

public SignalConnection<FindController.CountedMatchesCallback> onCountedMatches(FindController.CountedMatchesCallback handler)

This signal is emitted when the WebKitFindController has counted the number of matches for a given text after a call to webkit_find_controller_count_matches().

Parameters:

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

See Also:

• FindController.CountedMatchesCallback.run(int)

emitCountedMatches

public void emitCountedMatches(int matchCount)

Emits the "counted-matches" signal. See onCountedMatches(FindController.CountedMatchesCallback).

onFailedToFindText

public SignalConnection<FindController.FailedToFindTextCallback> onFailedToFindText(FindController.FailedToFindTextCallback handler)

This signal is emitted when a search operation does not find any result for the given text. It will be issued if the text is not found asynchronously after a call to webkit_find_controller_search(), webkit_find_controller_search_next() or webkit_find_controller_search_previous().

Parameters:

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

See Also:

• FindController.FailedToFindTextCallback.run()

emitFailedToFindText

public void emitFailedToFindText()

Emits the "failed-to-find-text" signal. See onFailedToFindText(FindController.FailedToFindTextCallback).

onFoundText

public SignalConnection<FindController.FoundTextCallback> onFoundText(FindController.FoundTextCallback handler)

This signal is emitted when a given text is found in the web page text. It will be issued if the text is found asynchronously after a call to webkit_find_controller_search(), webkit_find_controller_search_next() or webkit_find_controller_search_previous().

Parameters:

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

See Also:

• FindController.FoundTextCallback.run(int)

emitFoundText

public void emitFoundText(int matchCount)

Emits the "found-text" signal. See onFoundText(FindController.FoundTextCallback).

builder

public static FindController.Builder<? extends FindController.Builder> builder()

A FindController.Builder object constructs a FindController with the specified properties. Use the various set...() methods to set properties, and finish construction with FindController.Builder.build().

Returns:

the builder object