Package org.gnome.gtksourceview

Class SnippetManager

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gtksourceview.SnippetManager

All Implemented Interfaces:

Proxy

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

Provides access to Snippet.

GtkSourceSnippetManager is an object which processes snippet description files and creates Snippet objects.

Use getDefault() to retrieve the default instance of GtkSourceSnippetManager.

Use getSnippet(java.lang.String, java.lang.String, java.lang.String) to retrieve snippets for a given snippets.

Nested Class Summary

Nested Classes

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

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

GObject.NotifyCallback, GObject.ObjectClass

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
protected SnippetManager	asParent()	Returns this instance as if it were its parent type.
static SnippetManager.Builder<? extends SnippetManager.Builder>	builder()	A SnippetManager.Builder object constructs a SnippetManager with the specified properties.
static SnippetManager	getDefault()	Returns the default GtkSourceSnippetManager instance.
String[]	getSearchPath()	Gets the list directories where this SnippetManager looks for snippet files.
@Nullable Snippet	getSnippet(@Nullable String group, @Nullable String languageId, String trigger)	Queries the known snippets for the first matching group, languageId, and/or trigger.
static @Nullable Type	getType()	Get the GType of the SnippetManager class
ListModel	listAll()	Gets a ListModel of all snippets.
String[]	listGroups()	List all the known groups within the snippet manager.
ListModel	listMatching(@Nullable String group, @Nullable String languageId, @Nullable String triggerPrefix)	Queries the known snippets for those matching group, languageId, and/or triggerPrefix.
void	setSearchPath(@Nullable String @Nullable [] dirs)	Sets the list of directories in which the GtkSourceSnippetManager looks for snippet files.

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, getMemoryLayout, 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

SnippetManager

public SnippetManager(MemorySegment address)

Create a SnippetManager proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

SnippetManager

public SnippetManager()

Creates a new SnippetManager.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the SnippetManager class

Returns:

the GType

asParent

protected SnippetManager 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

getDefault

public static SnippetManager getDefault()

Returns the default GtkSourceSnippetManager instance.

Returns:

a GtkSourceSnippetManager which is owned by GtkSourceView library and must not be unref'd.

getSearchPath

public String[] getSearchPath()

Gets the list directories where this SnippetManager looks for snippet files.

Returns:

null-terminated array containing a list of snippet files directories. The array is owned by lm and must not be modified.

getSnippet

public @Nullable Snippet getSnippet(@Nullable String group,
 @Nullable String languageId,
 String trigger)

Queries the known snippets for the first matching group, languageId, and/or trigger.

If group or languageId are null, they will be ignored.

Parameters:

group - a group name or null

languageId - a GtkSourceLanguage:id or null

trigger - the trigger for the snippet

Returns:

a GtkSourceSnippet or null if no matching snippet was found.

listAll

public ListModel listAll()

Gets a ListModel of all snippets.

This can be used to get an unfiltered list of all of the snippets known to the snippet manager.

Returns:

a ListModel of Snippet

Since:

5.6

listGroups

public String[] listGroups()

List all the known groups within the snippet manager.

The result should be freed with g_free(), and the individual strings are owned by this SnippetManager and should never be freed by the caller.

Returns:

An array of strings which should be freed with g_free().

listMatching

public ListModel listMatching(@Nullable String group,
 @Nullable String languageId,
 @Nullable String triggerPrefix)

Queries the known snippets for those matching group, languageId, and/or triggerPrefix.

If any of these are null, they will be ignored when filtering the available snippets.

The ListModel only contains information about the available snippets until ListModel.getItem(int) is called for a specific snippet. This helps reduce the number of GObject's that are created at runtime to those needed by the calling application.

Parameters:

group - a group name or null

languageId - a GtkSourceLanguage:id or null

triggerPrefix - a prefix for a trigger to activate

Returns:

a GListModel of GtkSourceSnippet.

setSearchPath

public void setSearchPath(@Nullable String @Nullable [] dirs)

Sets the list of directories in which the GtkSourceSnippetManager looks for snippet files.

If dirs is null, the search path is reset to default.

At the moment this function can be called only before the snippet files are loaded for the first time. In practice to set a custom search path for a GtkSourceSnippetManager, you have to call this function right after creating it.

Parameters:

dirs - a null-terminated array of strings or null.

builder

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

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

Returns:

the builder object