Package org.gnome.gtksourceview

Class AnnotationProvider

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gtksourceview.AnnotationProvider

All Implemented Interfaces:

Proxy

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

It is used to provide annotations and display them on View and also populate HoverDisplay when the user hovers over an annotation.

You can subclass this object and implement populateHoverAsync(org.gnome.gtksourceview.Annotation, org.gnome.gtksourceview.HoverDisplay, org.gnome.gio.Cancellable, org.gnome.gio.AsyncReadyCallback) and populateHoverFinish(org.gnome.gio.AsyncResult) or connect to AnnotationProvider::populate and call AnnotationProvider#populate or do it asynchronously.

Since:

5.18

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AnnotationProvider.AnnotationProviderClass
static class	AnnotationProvider.Builder<B extends AnnotationProvider.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static interface	AnnotationProvider.ChangedCallback	Functional interface declaration of the ChangedCallback callback.

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

GObject.NotifyCallback, GObject.ObjectClass

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
void	addAnnotation(Annotation annotation)	Add an annotation to the provider.
protected AnnotationProvider	asParent()	Returns this instance as if it were its parent type.
static AnnotationProvider.Builder<? extends AnnotationProvider.Builder>	builder()	A AnnotationProvider.Builder object constructs a AnnotationProvider with the specified properties.
void	emitChanged()
static MemoryLayout	getMemoryLayout()	The memory layout of the native struct.
static @Nullable Type	getType()	Get the GType of the AnnotationProvider class
SignalConnection<AnnotationProvider.ChangedCallback>	onChanged(AnnotationProvider.ChangedCallback handler)
void	populateHoverAsync(Annotation annotation, HoverDisplay display, @Nullable Cancellable cancellable, @Nullable AsyncReadyCallback callback)	Used to populate the HoverDisplay asynchronously, use AnnotationProvider#populateHover to do it synchronously.
boolean	populateHoverFinish(AsyncResult result)	Finishes populating the HoverDisplay asynchronously.
void	removeAll()	Removes all annotations from the provider.
boolean	removeAnnotation(Annotation annotation)	Remove an annotation from the provider.

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

AnnotationProvider

public AnnotationProvider(MemorySegment address)

Create a AnnotationProvider proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

AnnotationProvider

public AnnotationProvider()

Creates a new AnnotationProvider.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the AnnotationProvider class

Returns:

the GType

getMemoryLayout

public static MemoryLayout getMemoryLayout()

The memory layout of the native struct.

Returns:

the memory layout

asParent

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

addAnnotation

public void addAnnotation(Annotation annotation)

Add an annotation to the provider.

Since:

5.18

populateHoverAsync

public void populateHoverAsync(Annotation annotation,
 HoverDisplay display,
 @Nullable Cancellable cancellable,
 @Nullable AsyncReadyCallback callback)

Used to populate the HoverDisplay asynchronously, use AnnotationProvider#populateHover to do it synchronously.

Parameters:

annotation - a GtkSourceAnnotation

display - a GtkSourceHoverDisplay to populate

Since:

5.18

populateHoverFinish

public boolean populateHoverFinish(AsyncResult result)
                            throws GErrorException

Finishes populating the HoverDisplay asynchronously.

Returns:

true if successful; otherwise false and error is set.

Throws:

GErrorException - see GError

Since:

5.18

removeAll

public void removeAll()

Removes all annotations from the provider.

Since:

5.18

removeAnnotation

public boolean removeAnnotation(Annotation annotation)

Remove an annotation from the provider.

Returns:

true if the annotation was found and removed

Since:

5.18

onChanged

public SignalConnection<AnnotationProvider.ChangedCallback> onChanged(AnnotationProvider.ChangedCallback handler)

See Also:

• AnnotationProvider.ChangedCallback.run()

emitChanged

public void emitChanged()

builder

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

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

Returns:

the builder object