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:

  • 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(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(MemorySegment, int) method.
      Specified by:
      toCallback in interface FunctionPointer
      Parameters:
      arena - the arena in which the function pointer is allocated
      Returns:
      the native function pointer