tepl_settings_get_singleton ()

TeplSettings *
tepl_settings_get_singleton (void);

Since: 6.2

tepl_settings_peek_desktop_interface_settings ()

GSettings *
tepl_settings_peek_desktop_interface_settings
                               (TeplSettings *self);

Since: 6.2

tepl_settings_provide_font_settings ()

void
tepl_settings_provide_font_settings (TeplSettings *self,
                                     GSettings *font_settings,
                                     const gchar *use_default_font_key,
                                     const gchar *editor_font_key);

This function can only be called once, to provide two keys:

See tepl_settings_get_selected_font().

Since: 6.2

tepl_settings_get_selected_font ()

gchar *
tepl_settings_get_selected_font (TeplSettings *self);

If tepl_settings_provide_font_settings() has *not* been called, this function always returns the current value of the system's fixed width (monospace) font.

If tepl_settings_provide_font_settings() *has* been called, this function returns the font name depending on the boolean value of use_default_font_key .

See also the “font-changed” signal, tepl_utils_override_font_string() and tepl_prefs_create_font_component().

Since: 6.2

tepl_settings_handle_theme_variant ()

void
tepl_settings_handle_theme_variant (TeplSettings *self,
                                    GSettings *theme_variant_settings,
                                    const gchar *theme_variant_setting_key);

This function permits to setup correctly the GTK theme variant to use.

If theme_variant_settings and theme_variant_setting_key are NULL, only the system's settings will be taken into account.

If theme_variant_settings and theme_variant_setting_key are provided, they are taken into account according to TeplSettingsThemeVariant.

You should call this function or tepl_settings_handle_simple_theme_variant() only once, as subsequent calls are ignored (the setting used cannot be reconfigured).

Since: 6.10

tepl_settings_handle_simple_theme_variant ()

void
tepl_settings_handle_simple_theme_variant
                               (TeplSettings *self,
                                GSettings *theme_variant_settings,
                                const gchar *theme_variant_setting_key);

Like tepl_settings_handle_theme_variant() but uses the TeplSettingsSimpleThemeVariant enum instead.

If theme_variant_settings and theme_variant_setting_key are NULL, the light GTK theme variant is forced.

You should call this function or tepl_settings_handle_theme_variant() only once, as subsequent calls are ignored (the setting used cannot be reconfigured).

Since: 6.10

tepl_settings_get_range_uint ()

gboolean
tepl_settings_get_range_uint (GSettings *settings,
                              const gchar *key,
                              guint32 *min,
                              guint32 *max);

This function introspects a GSettings key to get its range, if the key as a "u" type (unsigned integer). FALSE is returned if the introspection failed.

See g_settings_schema_key_get_range() for more flexibility.

Since: 6.2

struct TeplSettings

struct TeplSettings;

enum TeplSettingsThemeVariant

This enum is intended to be used for controlling the GTK theme preference.

See also TeplSettingsSimpleThemeVariant.

Since: 6.10

enum TeplSettingsSimpleThemeVariant

This enum is intended to be used for controlling the GTK theme preference.

See also TeplSettingsThemeVariant.

Since: 6.10

The “font-changed” signal

void
user_function (TeplSettings *settings,
               gpointer      user_data)

The ::font-changed signal is emitted when the return value of tepl_settings_get_selected_font() has potentially changed.

It takes into account the use_default_font_key provided with tepl_settings_provide_font_settings() to avoid unnecessary signal emission. In other words, for example if use_default_font_key is FALSE, the signal is not emitted even if the default (system's) font has been modified.

The relation between this signal and a potential zoom in and zoom out feature, to temporarily make the font larger or smaller (so the zoom level not being stored in GSettings): when this signal is emitted, it means that the user has explicitly changed the font setting, and as such he or she probably wants to use that font instead. So the expected behavior in that case is to reset the zoom level. But it's left as an exercise for another class, since TeplSettings is only for GSettings.

Flags: Run First

Since: 6.2