Package org.gnome.gio

Interface Settings.WritableChangeEventCallback

All Superinterfaces:

FunctionPointer

Enclosing class:

Settings

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public static interface Settings.WritableChangeEventCallback
extends FunctionPointer

Functional interface declaration of the WritableChangeEventCallback callback.

See Also:

• run(int)

Method Summary

Modifier and Type	Method	Description
boolean	run(int key)	Emitted once per writability change event that affects this settings object.
default MemorySegment	toCallback(Arena arena)	Creates a native function pointer to the upcall(java.lang.foreign.MemorySegment, int) method.
default int	upcall(MemorySegment sourceSettings, int key)	The upcall method is called from native code.

Method Details

run

boolean run(int key)

Emitted once per writability change event that affects this settings object.

You should connect to this signal if you are interested in viewing groups of changes before they are split out into multiple emissions of the Gio.Settings::writable-changed signal. For most use cases it is more appropriate to use the Gio.Settings::writable-changed signal.

In the event that the writability change applies only to a single key, key will be set to the GLib.Quark for that key. In the event that the writability change affects the entire settings object, key will be 0.

The default handler for this signal invokes the Gio.Settings::writable-changed and Gio.Settings::changed signals for each affected key. This is done because changes in writability might also imply changes in value (if for example, a new mandatory setting is introduced). If any other connected handler returns true then this default functionality will be suppressed.

upcall

default int upcall(MemorySegment sourceSettings,
 int key)

The upcall method is called from native code. The parameters are marshaled and run(int) is executed.

toCallback

default MemorySegment toCallback(Arena arena)

Creates a native function pointer to the upcall(java.lang.foreign.MemorySegment, int) method.

Specified by:

toCallback in interface FunctionPointer

Parameters:

arena - the function pointer will be allocated in this arena

Returns:

the native function pointer