Package ch.bailu.gtk.gtk

Class Settings

java.lang.Object

ch.bailu.gtk.type.Type

ch.bailu.gtk.type.Pointer

ch.bailu.gtk.gobject.Object

ch.bailu.gtk.gtk.Settings

All Implemented Interfaces:

PointerInterface

public class Settings
extends Object

`GtkSettings` provides a mechanism to share global settings between
applications.

On the X window system, this sharing is realized by an
[XSettings](http://www.freedesktop.org/wiki/Specifications/xsettings-spec)
manager that is usually part of the desktop environment, along with
utilities that let the user change these settings.

On Wayland, the settings are obtained either via a settings portal,
or by reading desktop settings from DConf.

In the absence of these sharing mechanisms, GTK reads default values for
settings from `settings.ini` files in `/etc/gtk-4.0`, `$XDG_CONFIG_DIRS/gtk-4.0`
and `$XDG_CONFIG_HOME/gtk-4.0`. These files must be valid key files (see
`GKeyFile`), and have a section called Settings. Themes can also provide
default values for settings by installing a `settings.ini` file
next to their `gtk.css` file.

Applications can override system-wide settings by setting the property
of the `GtkSettings` object with g_object_set(). This should be restricted
to special cases though; `GtkSettings` are not meant as an application
configuration facility.

There is one `GtkSettings` instance per display. It can be obtained with
[func@Gtk.Settings.get_for_display], but in many cases, it is more
convenient to use [method@Gtk.Widget.get_settings].

https://docs.gtk.org/gtk4/class.Settings.html

Nested Class Summary

Nested classes/interfaces inherited from class ch.bailu.gtk.gobject.Object

Object.OnBindingTransformFunc, Object.OnDestroyNotify, Object.OnDuplicateFunc, Object.OnNotify, Object.OnToggleNotify, Object.OnWeakNotify

Field Summary

Fields inherited from class ch.bailu.gtk.gobject.Object

SIGNAL_ON_NOTIFY

Fields inherited from class ch.bailu.gtk.type.Pointer

NULL

Constructor Summary

Constructors

Constructor	Description
Settings(PointerContainer pointer)

Method Summary

Modifier and Type	Method	Description
StyleProvider	asStyleProvider()	Implements interface StyleProvider.
static ClassHandler	getClassHandler()
static Settings	getDefault()	Gets the `GtkSettings` object for the default display, creating it if necessary.
static Settings	getForDisplay(Display display)	Gets the `GtkSettings` object for @display, creating it if necessary.
static int	getInstanceSize()
static long	getParentTypeID()
static TypeSystem.TypeSize	getParentTypeSize()
static long	getTypeID()
static TypeSystem.TypeSize	getTypeSize()
void	resetProperty(Str name)	Undoes the effect of calling g_object_set() to install an application-specific value for a setting.
void	resetProperty(String name)	Undoes the effect of calling g_object_set() to install an application-specific value for a setting.

Methods inherited from class ch.bailu.gtk.gobject.Object

addToggleRef, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, disconnect, disconnect, dupData, dupData, dupQdata, forceFloating, freezeNotify, get, get, getData, getData, getProperty, getProperty, getQdata, interfaceFindProperty, interfaceInstallProperty, isFloating, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, replaceData, replaceData, replaceQdata, runDispose, set, set, setData, setData, setDataFull, setDataFull, setProperty, setProperty, setQdata, setQdataFull, stealData, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref

Methods inherited from class ch.bailu.gtk.type.Pointer

asCPointer, cast, connectSignal, disconnectSignals, disconnectSignals, equals, hashCode, throwIfNull, throwNullPointerException, toString, unregisterCallbacks, unregisterCallbacks

Methods inherited from class ch.bailu.gtk.type.Type

asCPointer, asCPointer, asCPointerNotNull, asJnaPointer, asJnaPointer, asPointer, asPointer, cast, cast, throwIfNull

Methods inherited from class java.lang.Object

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

Methods inherited from interface ch.bailu.gtk.type.PointerInterface

asCPointerNotNull, asJnaPointer, asPointer, isNotNull, isNull

Constructor Details

Settings

public Settings(PointerContainer pointer)

Method Details

getClassHandler

public static ClassHandler getClassHandler()

resetProperty

public void resetProperty(@Nonnull
 Str name)

Undoes the effect of calling g_object_set() to install an
application-specific value for a setting.

After this call, the setting will again follow the session-wide
value for this setting.

Parameters:

name - the name of the setting to reset

resetProperty

public void resetProperty(String name)

Undoes the effect of calling g_object_set() to install an
application-specific value for a setting.

After this call, the setting will again follow the session-wide
value for this setting.

Parameters:

name - the name of the setting to reset

getDefault

public static Settings getDefault()

Gets the `GtkSettings` object for the default display, creating
it if necessary.

See [func@Gtk.Settings.get_for_display].

Returns:

a `GtkSettings` object. If there is no default display, then returns %NULL.

getForDisplay

public static Settings getForDisplay(@Nonnull
 Display display)

Gets the `GtkSettings` object for @display, creating it if necessary.

Parameters:

display - a `GdkDisplay`

Returns:

a `GtkSettings` object

asStyleProvider

public StyleProvider asStyleProvider()

Implements interface StyleProvider. Call this to get access to interface functions.

Returns:

StyleProvider

getTypeID

public static long getTypeID()

getParentTypeID

public static long getParentTypeID()

getTypeSize

public static TypeSystem.TypeSize getTypeSize()

getParentTypeSize

public static TypeSystem.TypeSize getParentTypeSize()

getInstanceSize

public static int getInstanceSize()