Package org.gnome.gtksourceview

Class SearchSettings

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gtksourceview.SearchSettings

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
public class SearchSettings
extends GObject

Search settings.

A GtkSourceSearchSettings object represents the settings of a search. The search settings can be associated with one or several SearchContexts.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SearchSettings.Builder<B extends SearchSettings.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static class	SearchSettings.SearchSettingsClass

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Constructor Summary

Constructors

Constructor	Description
SearchSettings()	Creates a new SearchSettings.
SearchSettings(MemorySegment address)	Create a SearchSettings proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
protected SearchSettings	asParent()	Returns this instance as if it were its parent type.
static SearchSettings.Builder<? extends SearchSettings.Builder>	builder()	A SearchSettings.Builder object constructs a SearchSettings with the specified properties.
boolean	getAtWordBoundaries()
boolean	getCaseSensitive()
static MemoryLayout	getMemoryLayout()	The memory layout of the native struct.
boolean	getRegexEnabled()
@Nullable String	getSearchText()	Gets the text to search.
static @Nullable Type	getType()	Get the GType of the SearchSettings class
boolean	getVisibleOnly()
boolean	getWrapAround()
void	setAtWordBoundaries(boolean atWordBoundaries)	Change whether the search is done at word boundaries.
void	setCaseSensitive(boolean caseSensitive)	Enables or disables the case sensitivity for the search.
void	setRegexEnabled(boolean regexEnabled)	Enables or disables whether to search by regular expressions.
void	setSearchText(@Nullable String searchText)	Sets the text to search.
void	setVisibleOnly(boolean visibleOnly)	Enables or disables whether to exclude invisible text from the search.
void	setWrapAround(boolean wrapAround)	Enables or disables the wrap around search.

Methods inherited from class org.gnome.gobject.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 org.gnome.gobject.TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class org.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

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

Constructor Details

SearchSettings

public SearchSettings(MemorySegment address)

Create a SearchSettings proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

SearchSettings

public SearchSettings()

Creates a new SearchSettings.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the SearchSettings class

Returns:

the GType

getMemoryLayout

public static MemoryLayout getMemoryLayout()

The memory layout of the native struct.

Returns:

the memory layout

asParent

protected SearchSettings asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class GObject

getAtWordBoundaries

public boolean getAtWordBoundaries()

getCaseSensitive

public boolean getCaseSensitive()

getRegexEnabled

public boolean getRegexEnabled()

getSearchText

public @Nullable String getSearchText()

Gets the text to search.

The return value must not be freed.

You may be interested to call GtkSource.utilsEscapeSearchText(java.lang.String) after this function.

Returns:

the text to search, or null if the search is disabled.

getVisibleOnly

public boolean getVisibleOnly()

getWrapAround

public boolean getWrapAround()

setAtWordBoundaries

public void setAtWordBoundaries(boolean atWordBoundaries)

Change whether the search is done at word boundaries.

If atWordBoundaries is true, a search match must start and end a word. The match can span multiple words. See also TextIter.startsWord() and TextIter.endsWord().

Parameters:

atWordBoundaries - the setting.

setCaseSensitive

public void setCaseSensitive(boolean caseSensitive)

Enables or disables the case sensitivity for the search.

Parameters:

caseSensitive - the setting.

setRegexEnabled

public void setRegexEnabled(boolean regexEnabled)

Enables or disables whether to search by regular expressions.

If enabled, the SearchSettings:search-text property contains the pattern of the regular expression.

SearchContext uses GRegex when regex search is enabled. See the Regular expression syntax page in the GLib reference manual.

Parameters:

regexEnabled - the setting.

setSearchText

public void setSearchText(@Nullable String searchText)

Sets the text to search.

If searchText is null or is empty, the search will be disabled. A copy of searchText will be made, so you can safely free searchText after a call to this function.

You may be interested to call GtkSource.utilsUnescapeSearchText(java.lang.String) before this function.

Parameters:

searchText - the nul-terminated text to search, or null to disable the search.

setVisibleOnly

public void setVisibleOnly(boolean visibleOnly)

Enables or disables whether to exclude invisible text from the search.

If enabled, only visible text will be searched. A search match may have invisible text interspersed.

Parameters:

visibleOnly - the setting.

Since:

5.12

setWrapAround

public void setWrapAround(boolean wrapAround)

Enables or disables the wrap around search.

If wrapAround is true, the forward search continues at the beginning of the buffer if no search occurrences are found. Similarly, the backward search continues to search at the end of the buffer.

Parameters:

wrapAround - the setting.

builder

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

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

Returns:

the builder object