GSettings Utilities

Files
file	gnc-gsettings.h
	GSettings helper routines.

Macros
#define	GSET_SCHEMA_PREFIX   "org.gnucash"

Functions
gchar *	gnc_gsettings_normalize_schema_name (const gchar *name)
void	gnc_gsettings_set_prefix (const gchar *prefix)
const gchar *	gnc_gsettings_get_prefix (void)
void	gnc_gsettings_load_backend (void)
void	gnc_gsettings_migrate_from_gconf (void)

Listening for changes
gulong	gnc_gsettings_register_cb (const char *schema, const gchar *key, gpointer func, gpointer user_data)
void	gnc_gsettings_remove_cb_by_func (const gchar *schema, const gchar *key, gpointer func, gpointer user_data)
void	gnc_gsettings_remove_cb_by_id (const gchar *schema, guint id)
guint	gnc_gsettings_register_any_cb (const gchar *schema, gpointer func, gpointer user_data)
void	gnc_gsettings_remove_any_cb_by_func (const gchar *schema, gpointer func, gpointer user_data)
void	gnc_gsettings_bind (const gchar *schema, const gchar *key, gpointer object, const gchar *property)

GSettings Get Functions
gboolean	gnc_gsettings_get_bool (const gchar *schema, const gchar *key)
gint	gnc_gsettings_get_int (const gchar *schema, const gchar *key)
gdouble	gnc_gsettings_get_float (const gchar *schema, const gchar *key)
gchar *	gnc_gsettings_get_string (const gchar *schema, const gchar *key)
gint	gnc_gsettings_get_enum (const gchar *schema, const gchar *key)
GVariant *	gnc_gsettings_get_value (const gchar *schema, const gchar *key)

GSettings Set/Unset Functions
gboolean	gnc_gsettings_set_bool (const gchar *schema, const gchar *key, gboolean value)
gboolean	gnc_gsettings_set_int (const gchar *schema, const gchar *key, gint value)
gboolean	gnc_gsettings_set_float (const gchar *schema, const gchar *key, gdouble value)
gboolean	gnc_gsettings_set_string (const gchar *schema, const gchar *key, const gchar *value)
gboolean	gnc_gsettings_set_enum (const gchar *schema, const gchar *key, gint value)
gboolean	gnc_gsettings_set_value (const gchar *schema, const gchar *key, GVariant *value)
void	gnc_gsettings_reset (const gchar *schema, const gchar *key)
void	gnc_gsettings_reset_schema (const gchar *schema)

Detailed Description

The API in this file is designed to make it easy to use the GSettings system from within Gnucash. GSettings is a shared key/value storage system.

The main benefits of these routines are that they

1. maintain a list of GSettings objects (one per schema),
2. convert gnucash internal schema names into full gsettings schema id's, and
3. optionally take care of error checking on return values.

Note that this api should not be called directly. Instead use the gnc_gsettings_load_backend function to configure gsettings as backend for the gnucash preferences api and then use the gnc_prefs_* functions instead to work with preferences.

Function Documentation

void gnc_gsettings_bind	(	const gchar *	schema,
		const gchar *	key,
		gpointer	object,
		const gchar *	property
	)

Bind a setting to a g_object property. When this succeeds a change of the setting will automatically update the bound object property and vice versa.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.
object	The object to be bound.
property	The property of the object to bind to.

Definition at line 254 of file gnc-gsettings.c.

{
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_if_fail (G_IS_SETTINGS (schema_ptr));

    if (gnc_gsettings_is_valid_key (schema_ptr, key))
        g_settings_bind (schema_ptr, key, object, property, 0);
    else
    {
        PERR ("Invalid key %s for schema %s", key, schema);
    }
}

gboolean gnc_gsettings_get_bool	(	const gchar *	schema,
		const gchar *	key
	)

Get a boolean value from GSettings.

Retrieve a TRUE/FALSE value from GSettings. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.

Returns

This function returns the TRUE or FALSE value stored at the requested key in the gsettings database. If the key has never been set, this function passes on the default value returned by GSettings as specified in the schema for this key.

Definition at line 275 of file gnc-gsettings.c.

{
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_val_if_fail (G_IS_SETTINGS (schema_ptr), FALSE);

    if (gnc_gsettings_is_valid_key (schema_ptr, key))
        return g_settings_get_boolean (schema_ptr, key);
    else
    {
        PERR ("Invalid key %s for schema %s", key, schema);
        return FALSE;
    }
}

gint gnc_gsettings_get_enum	(	const gchar *	schema,
		const gchar *	key
	)

Get an enum value from GSettings.

Retrieve an enum value from GSettings. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.

Returns

This function returns the enum value stored at the requested key in the gsettings database. If the key has never been set, this function passes on the default value returned by GSettings as specified in the schema for this key. If there is an error in processing, this function passed on the value of zero as returned by GSettings.

Definition at line 427 of file gnc-gsettings.c.

{
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_val_if_fail (G_IS_SETTINGS (schema_ptr), 0);

    if (gnc_gsettings_is_valid_key (schema_ptr, key))
        return g_settings_get_enum (schema_ptr, key);
    else
    {
        PERR ("Invalid key %s for schema %s", key, schema);
        return 0;
    }
}

gdouble gnc_gsettings_get_float	(	const gchar *	schema,
		const gchar *	key
	)

Get an float value from GSettings.

Retrieve an float value from GSettings. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.

Returns

This function returns the float value stored at the requested key in the gsettings database. If the key has never been set, this function passes on the default value returned by GSettings as specified in the schema for this key. If there is an error in processing, this function passed on the value of zero as returned by GSettings.

Definition at line 351 of file gnc-gsettings.c.

{
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_val_if_fail (G_IS_SETTINGS (schema_ptr), 0);

    if (gnc_gsettings_is_valid_key (schema_ptr, key))
        return g_settings_get_double (schema_ptr, key);
    else
    {
        PERR ("Invalid key %s for schema %s", key, schema);
        return 0;
    }
}

gint gnc_gsettings_get_int	(	const gchar *	schema,
		const gchar *	key
	)

Get an integer value from GSettings.

Retrieve an integer value from GSettings. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.

Returns

This function returns the integer value stored at the requested key in the gsettings database. If the key has never been set, this function passes on the default value returned by GSettings as specified in the schema for this key. If there is an error in processing, this function passed on the value of zero as returned by GSettings.

Definition at line 314 of file gnc-gsettings.c.

{
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_val_if_fail (G_IS_SETTINGS (schema_ptr), 0);

    if (gnc_gsettings_is_valid_key (schema_ptr, key))
        return g_settings_get_int (schema_ptr, key);
    else
    {
        PERR ("Invalid key %s for schema %s", key, schema);
        return 0;
    }
}

const gchar* gnc_gsettings_get_prefix

(

void

)

Get the default gsettings schema prefix. If none was set explicitly, this defaults to "org.gnucash"

Definition at line 128 of file gnc-gsettings.c.

{
    if (!gsettings_prefix)
    {
        const char *prefix = g_getenv("GNC_GSETTINGS_PREFIX");
        if (prefix)
            gsettings_prefix = prefix;
        else
            gsettings_prefix = GSET_SCHEMA_PREFIX;
    }
    return gsettings_prefix;
}

gchar* gnc_gsettings_get_string	(	const gchar *	schema,
		const gchar *	key
	)

Get a string value from GSettings.

Retrieve an string value from GSettings. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.

Returns

This function returns the string value stored at the requested key in the gsettings database. If the key has never been set, this function passes on the default value returned by GSettings as specified in the schema for this key. If there is an error in processing, this function passed on the NULL value as returned by GSettings. It is the callers responsibility to free any string returned by this function.

Definition at line 388 of file gnc-gsettings.c.

{
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_val_if_fail (G_IS_SETTINGS (schema_ptr), NULL);

    if (gnc_gsettings_is_valid_key (schema_ptr, key))
        return g_settings_get_string (schema_ptr, key);
    else
    {
        PERR ("Invalid key %s for schema %s", key, schema);
        return NULL;
    }
}

GVariant* gnc_gsettings_get_value	(	const gchar *	schema,
		const gchar *	key
	)

Get an arbitrary combination of values from GSettings.

Retrieve an arbitrary combination of values from GSettings. This combination of values can be anything that can be encapsulated in a GVariant structure. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.

Returns

This function returns the a GVariant encapsulating the combination of values stored at the requested key in the gsettings database. If the key has never been set, this function passes on the default value returned by GSettings as specified in the schema for this key. If there is an error in processing, this function passed on the NULL value as returned by GSettings. It is the callers responsibility to free any GVariant data returned by this function.

Definition at line 464 of file gnc-gsettings.c.

{
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_val_if_fail (G_IS_SETTINGS (schema_ptr), NULL);

    if (gnc_gsettings_is_valid_key (schema_ptr, key))
        return g_settings_get_value (schema_ptr, key);
    else
    {
        PERR ("Invalid key %s for schema %s", key, schema);
        return NULL;
    }
}

void gnc_gsettings_load_backend

(

void

)

Configure gsettings as the backend for the gnucash preferences api.

Definition at line 533 of file gnc-gsettings.c.

{
    ENTER("");

    /* The gsettings backend only works in an installed environment.
     * When called from the source environment (for testing purposes)
     * simply return.
     */
    if (g_strcmp0 (g_getenv ("GNC_UNINSTALLED"), "1") == 0)
        return;

    if (!prefsbackend)
        prefsbackend = g_new0 (PrefsBackend, 1);

    prefsbackend->register_cb = gnc_gsettings_register_cb;
    prefsbackend->remove_cb_by_func = gnc_gsettings_remove_cb_by_func;
    prefsbackend->remove_cb_by_id = gnc_gsettings_remove_cb_by_id;
    prefsbackend->register_group_cb = gnc_gsettings_register_any_cb;
    prefsbackend->remove_group_cb_by_func = gnc_gsettings_remove_any_cb_by_func;
    prefsbackend->bind = gnc_gsettings_bind;
    prefsbackend->get_bool = gnc_gsettings_get_bool;
    prefsbackend->get_int = gnc_gsettings_get_int;
    prefsbackend->get_float = gnc_gsettings_get_float;
    prefsbackend->get_string = gnc_gsettings_get_string;
    prefsbackend->get_enum = gnc_gsettings_get_enum;
    prefsbackend->get_value = gnc_gsettings_get_value;
    prefsbackend->set_bool = gnc_gsettings_set_bool;
    prefsbackend->set_int = gnc_gsettings_set_int;
    prefsbackend->set_float = gnc_gsettings_set_float;
    prefsbackend->set_string = gnc_gsettings_set_string;
    prefsbackend->set_enum = gnc_gsettings_set_enum;
    prefsbackend->set_value = gnc_gsettings_set_value;
    prefsbackend->reset = gnc_gsettings_reset;
    prefsbackend->reset_group = gnc_gsettings_reset_schema;

    LEAVE("Prefsbackend bind = %p", prefsbackend->bind);
}

gchar* gnc_gsettings_normalize_schema_name

(

const gchar *

name

)

Convert a partial schema name into a complete gsettings schema name.

This function takes a partial gsettings schema name and converts it into a fully qualified gsettings schema name. It does this by prepending the standard prefix for all gnucash schemas. If the schema is already fully qualified (i.e. begins with the default schema prefix, this routine will not change it.

Parameters

name	A partial schema name. The default prefix is prepended to this name to produce a fully qualified schema name.

Returns

This function returns a string pointer to the fully qualified schema name. It is the caller's responsibility to free this string.

Definition at line 142 of file gnc-gsettings.c.

{
    if (name == NULL)
    {
        /* Need to return a newly allocated string */
        return g_strdup(gnc_gsettings_get_prefix());
    }
    if (g_str_has_prefix (name, gnc_gsettings_get_prefix ()))
    {
        /* Need to return a newly allocated string */
        return g_strdup(name);
    }

    return g_strjoin(".", gnc_gsettings_get_prefix(), name, NULL);
}

guint gnc_gsettings_register_any_cb	(	const gchar *	schema,
		gpointer	func,
		gpointer	user_data
	)

Register a callback for when any key in the settings schema is changed. Any time the value of a key in this schema changes, the routine will be invoked and will be passed the specified user data.

Parameters

schema	This value contains the name of the schema that is being watched.
func	This is a pointer to the function to call when a key changes.
user_data	This pointer will be passed to the callback function.

Definition at line 237 of file gnc-gsettings.c.

{
    return gnc_gsettings_register_cb (schema, NULL, func, user_data);
}

gulong gnc_gsettings_register_cb	(	const char *	schema,
		const gchar *	key,
		gpointer	func,
		gpointer	user_data
	)

Register a callback for when a specific key in the settings schema is changed. Any time the key's value changes, the routine will be invoked and will be passed both the changed gsettings entry and the user data passed to this function.

Parameters

schema	This value contains the schema name of the key to watch.
key	This value contains the name of the key to watch.
func	This is a pointer to the function to call when the key changes.
user_data	This pointer will be passed to the callback function.

Returns

This function returns the handler id for the registered callback.

void gnc_gsettings_remove_any_cb_by_func	(	const gchar *	schema,
		gpointer	func,
		gpointer	user_data
	)

Remove a function that was registered for a callback when any key in the given settings schema changed. Both the func and user_data arguments are used to match up the callback to remove. If no matching func and user_data are found to be registered for the given key, nothing will happen.

Parameters

schema	This value contains the name of the schema that is being watched.
func	This is a pointer to the function that was registered earlier.
user_data	This pointer was passed to the callback function when it was registered.

Note

there is no gnc_settings_remove_any_cb_by_id. Use gnc_settings_remove_cb_by_id instead if you want to remove a callback set with gnc_settings_register_any_cb by its handler id.

Definition at line 246 of file gnc-gsettings.c.

{
    gnc_gsettings_remove_cb_by_func (schema, NULL, func, user_data);
}

void gnc_gsettings_remove_cb_by_func	(	const gchar *	schema,
		const gchar *	key,
		gpointer	func,
		gpointer	user_data
	)

Remove a function that was registered for a callback when a specific key in the settings schema changed. Both the func and user_data arguments are used to match up the callback to remove. If no matching func and user_data are found to be registered for the given key, nothing will happen.

Parameters

schema	This value contains the schema name of the key that is being watched.
key	This value contains the name of the key being watched.
func	This is a pointer to the function that was registered earlier.
user_data	This pointer was passed to the callback function when it was registered.

Definition at line 196 of file gnc-gsettings.c.

{
    gint matched = 0;
    GQuark quark = 0;

    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_if_fail (G_IS_SETTINGS (schema_ptr));
    g_return_if_fail (func);

    ENTER ();

    if ((key) && (gnc_gsettings_is_valid_key(schema_ptr, key)))
        quark = g_quark_from_string (key);

    matched = g_signal_handlers_disconnect_matched (
                  schema_ptr,
                  G_SIGNAL_MATCH_DETAIL | G_SIGNAL_MATCH_FUNC | G_SIGNAL_MATCH_DATA,
                  g_signal_lookup ("changed", G_TYPE_SETTINGS), /* signal_id */
                  quark,   /* signal_detail */
                  NULL, /* closure */
                  G_CALLBACK (func), /* callback function */
                  user_data);
    LEAVE ("Schema: %s, key: %s - removed %d handlers for 'changed' signal", schema, key, matched);
}

void gnc_gsettings_remove_cb_by_id	(	const gchar *	schema,
		guint	id
	)

Remove a function that was registered for a callback when a specific key in the settings schema changed. The handler id that was generated when the callback was registered is use to find the callback to remove. If no handler id is found nothing will happen.

Parameters

schema	This value contains the schema name of the key that is being watched.
id	The handler id of the callback to be removed.

Definition at line 226 of file gnc-gsettings.c.

{
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_if_fail (G_IS_SETTINGS (schema_ptr));

    g_signal_handler_disconnect (schema_ptr, handlerid);
}

void gnc_gsettings_reset	(	const gchar *	schema,
		const gchar *	key
	)

Reset a key to its default value in GSettings.

Reset a key to its default value in GSettings. Internally this is done by removing the value from the database. The next attempt to read this value will return the default as specified in the GSettings schema for this key. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.

Definition at line 501 of file gnc-gsettings.c.

{
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_if_fail (G_IS_SETTINGS (schema_ptr));

    if (gnc_gsettings_is_valid_key (schema_ptr, key))
        g_settings_reset (schema_ptr, key);
    else
        PERR ("Invalid key %s for schema %s", key, schema);
}

void gnc_gsettings_reset_schema

(

const gchar *

schema

)

Reset all keys in a schema to their default values in GSettings.

Reset a keys in schema to their default values in GSettings. Internally this is done by removing the values from the database. The next attempt to read a keys will return its default as specified in the GSettings schema for this key. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema

This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.

Definition at line 514 of file gnc-gsettings.c.

{
    gchar **keys;
    gint counter = 0;

    keys = g_settings_list_keys (gnc_gsettings_get_schema_ptr (schema));

    if (!keys)
        return;

    while (keys[counter])
    {
        gnc_gsettings_reset (schema, keys[counter]);
        counter++;
    }

    g_strfreev (keys);
}

gboolean gnc_gsettings_set_bool	(	const gchar *	schema,
		const gchar *	key,
		gboolean	value
	)

Store a boolean value into GSettings.

Store a boolean value into GSettings. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.
value	The boolean value to be stored.

Returns

This function returns true if the value was set successfully on the key or false if not.

Definition at line 291 of file gnc-gsettings.c.

{
    gboolean result = FALSE;
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_val_if_fail (G_IS_SETTINGS (schema_ptr), FALSE);

    ENTER("schema: %s, key: %s", schema, key);
    if (gnc_gsettings_is_valid_key (schema_ptr, key))
    {
        result = g_settings_set_boolean (schema_ptr, key, value);
        if (!result)
            PERR ("Unable to set value for key %s in schema %s", key, schema);
    }
    else
        PERR ("Invalid key %s for schema %s", key, schema);

    LEAVE("result %i", result);
    return result;
}

gboolean gnc_gsettings_set_enum	(	const gchar *	schema,
		const gchar *	key,
		gint	value
	)

Store an enum value into GSettings.

Store an enum into GSettings. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.
value	The enum number to be stored.

Returns

This function returns true if the value was set successfully on the key or false if not.

Definition at line 443 of file gnc-gsettings.c.

{
    gboolean result = FALSE;
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_val_if_fail (G_IS_SETTINGS (schema_ptr), FALSE);

    if (gnc_gsettings_is_valid_key (schema_ptr, key))
    {
        result = g_settings_set_enum (schema_ptr, key, value);
        if (!result)
            PERR ("Unable to set value for key %s in schema %s", key, schema);
    }
    else
        PERR ("Invalid key %s for schema %s", key, schema);

    return result;
}

gboolean gnc_gsettings_set_float	(	const gchar *	schema,
		const gchar *	key,
		gdouble	value
	)

Store a float value into GSettings.

Store a float into GSettings. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.
value	The floating point number to be stored.

Returns

This function returns true if the value was set successfully on the key or false if not.

Definition at line 367 of file gnc-gsettings.c.

{
    gboolean result = FALSE;
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_val_if_fail (G_IS_SETTINGS (schema_ptr), FALSE);

    if (gnc_gsettings_is_valid_key (schema_ptr, key))
    {
        result = g_settings_set_double (schema_ptr, key, value);
        if (!result)
            PERR ("Unable to set value for key %s in schema %s", key, schema);
    }
    else
        PERR ("Invalid key %s for schema %s", key, schema);

    return result;
}

gboolean gnc_gsettings_set_int	(	const gchar *	schema,
		const gchar *	key,
		gint	value
	)

Store an integer value into GSettings.

Store an integer into GSettings. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.
value	The integer number to be stored.

Returns

This function returns true if the value was set successfully on the key or false if not.

Definition at line 330 of file gnc-gsettings.c.

{
    gboolean result = FALSE;
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_val_if_fail (G_IS_SETTINGS (schema_ptr), FALSE);

    if (gnc_gsettings_is_valid_key (schema_ptr, key))
    {
        result = g_settings_set_int (schema_ptr, key, value);
        if (!result)
            PERR ("Unable to set value for key %s in schema %s", key, schema);
    }
    else
        PERR ("Invalid key %s for schema %s", key, schema);

    return result;
}

void gnc_gsettings_set_prefix

(

const gchar *

prefix

)

Set the default gsettings schema prefix. This is used to generate complete schema id's if only partial id's are passed.

Definition at line 122 of file gnc-gsettings.c.

{
    gsettings_prefix = prefix;
}

gboolean gnc_gsettings_set_string	(	const gchar *	schema,
		const gchar *	key,
		const gchar *	value
	)

Store a string into GSettings.

Store a single string into GSettings. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.
value	The string to be stored. GSettings will make a copy of this string, so it is the callers responsibility to free the space used by this string (if necessary).

Returns

This function returns true if the value was set successfully on the key or false if not.

Definition at line 404 of file gnc-gsettings.c.

{
    gboolean result = FALSE;
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_val_if_fail (G_IS_SETTINGS (schema_ptr), FALSE);

    ENTER("schema: %s, key: %s", schema, key);
    if (gnc_gsettings_is_valid_key (schema_ptr, key))
    {
        result = g_settings_set_string (schema_ptr, key, value);
        if (!result)
            PERR ("Unable to set value for key %s in schema %s", key, schema);
    }
    else
        PERR ("Invalid key %s for schema %s", key, schema);

    LEAVE("result %i", result);
    return result;
}

gboolean gnc_gsettings_set_value	(	const gchar *	schema,
		const gchar *	key,
		GVariant *	value
	)

Store an arbitrary combination of values into GSettings.

Store an arbitrary combination of values into GSettings. This combination of values can be anything that can be encapsulated in a GVariant structure. The schema name provided as argument is combined with the default gnucash schema prefix to produce a fully qualified schema name.

Parameters

schema	This string provides a grouping of keys within the GnuCash schema of the gsettings database. It can be a simple string as in "history" for settings that are common to many areas of gnucash, or it can be a partial path name as in "dialogs.business.invoice" for setting that only apply to one specific area of the program.
key	This string is the name of the particular key within the named schema of gsettings.
value	The combination of values encapsulated in a GVariant to be stored.

Returns

This function returns true if the value was set successfully on the key or false if not.

Definition at line 480 of file gnc-gsettings.c.

{
    gboolean result = FALSE;
    GSettings *schema_ptr = gnc_gsettings_get_schema_ptr (schema);
    g_return_val_if_fail (G_IS_SETTINGS (schema_ptr), FALSE);

    if (gnc_gsettings_is_valid_key (schema_ptr, key))
    {
        result = g_settings_set_value (schema_ptr, key, value);
        if (!result)
            PERR ("Unable to set value for key %s in schema %s", key, schema);
    }
    else
        PERR ("Invalid key %s for schema %s", key, schema);

    return result;
}