| Top |
void (*OGMRipSetFunc) (GObject *object,const gchar *property,const GValue *value,gpointer data);
Specifies the type of functions passed to ogmrip_settings_bind_custom() to set
the value of the property.
void (*OGMRipGetFunc) (GObject *object,const gchar *property,GValue *value,gpointer data);
Specifies the type of functions passed to ogmrip_settings_bind_custom() to get
the value of the property.
void (*OGMRipNotifyFunc) (OGMRipSettings *settings,const gchar *section,const gchar *key,const GValue *value,gpointer data);
Specifies the type of functions passed to ogmrip_settings_add_notify(),
and ogmrip_settings_add_notify_while_alive().
gulong ogmrip_settings_add_notify (OGMRipSettings *settings,const gchar *section,const gchar *key,OGMRipNotifyFunc func,gpointer data);
Request notification of changes of key
in section
.
gulong ogmrip_settings_add_notify_while_alive (OGMRipSettings *settings,const gchar *section,const gchar *key,OGMRipNotifyFunc func,gpointer data,GObject *object);
Request notification of changes of key
in section
. When object
is destroyed,
the notification is automatically removed.
settings |
||
section |
the section |
|
key |
the key |
|
func |
function to call when changes occur |
|
data |
user data to pass to |
|
object |
a GObject |
void ogmrip_settings_bind (OGMRipSettings *settings,const gchar *section,const gchar *key,GObject *object,const gchar *property);
Binds key
in section
with property
of object
. Whenever property
changes,
key
is updated. Whenever key
changeѕ, property
is updated.
void ogmrip_settings_bind_custom (OGMRipSettings *settings,const gchar *section,const gchar *key,GObject *object,const gchar *property,OGMRipGetFunc get_func,OGMRipSetFunc set_func,gpointer data);
Binds key
in section
with property
of object
. Whenever property
changes,
key
is updated. Whenever key
changeѕ, property
is updated.
settings |
||
section |
the section |
|
key |
the key |
|
object |
a GObject |
|
property |
a property of |
|
get_func |
function called whenever |
|
set_func |
function called whenever |
|
data |
user data to pass to |
void ogmrip_settings_block (OGMRipSettings *settings,const gchar *section,const gchar *key);
Blocks all notifications related to key
in section
. If section
is NULL, notifications
related to key
from all sections are blocked.
gchar * ogmrip_settings_build_section (OGMRipSettings *settings,const gchar *element,...);
Builds a section from many section elements.
gint ogmrip_settings_compare_versions (const gchar *version1,const gchar *version2);
Compares the versions of two profiles.
gboolean ogmrip_settings_export (OGMRipSettings *settings,const gchar *section,const gchar *filename,GError **error);
Exports settings from section
in filename
.
GParamSpec * ogmrip_settings_find_key (OGMRipSettings *settings,const gchar *key);
Looks up the GParamSpec for a key.
void ogmrip_settings_get (OGMRipSettings *settings,const gchar *section,const gchar *key,...);
Gets the values associated with any number of settings in the same section.
settings |
||
section |
the section of the keys |
|
key |
the name of the first key to fetch |
|
... |
pointers to the locations to store the value of the first key, followed
by more name/pointer groupings, followed by |
OGMRipSettings *
ogmrip_settings_get_default (void);
Gets the default setting manager if it exists.
GSList * ogmrip_settings_get_keys (OGMRipSettings *settings,const gchar *section,gboolean recursive);
Lists the keys in section
. The returned list contains allocated
strings. You should g_free() each string in the list, then g_slist_free() the
list itself.
GType ogmrip_settings_get_key_type (OGMRipSettings *settings,const gchar *section,const gchar *key);
Gets the type of the setting named by key
in section
.
const gchar * ogmrip_settings_get_section_name (OGMRipSettings *settings,const gchar *section);
Gets the name of the section.
GSList * ogmrip_settings_get_subsections (OGMRipSettings *settings,const gchar *section);
Lists the subsections in section
. The returned list contains allocated
strings. You should g_free() each string in the list, then g_slist_free() the
list itself.
void ogmrip_settings_get_value (OGMRipSettings *settings,const gchar *section,const gchar *key,GValue *value);
Gets the value associated with the setting named by key
in section
.
settings |
||
section |
the section of the key |
|
key |
the name of the key to fetch |
|
value |
a GValue of the correct type |
gboolean ogmrip_settings_has_key (OGMRipSettings *settings,const gchar *section,const gchar *key);
Returns whether a key exists or not.
gboolean ogmrip_settings_has_section (OGMRipSettings *settings,const gchar *section);
Returns whether a section exists or not.
gboolean ogmrip_settings_import (OGMRipSettings *settings,const gchar *filename,gchar **section,GError **error);
Imports settings from filename
in section
.
void ogmrip_settings_install_key (OGMRipSettings *settings,GParamSpec *pspec);
Installs a new key.
void ogmrip_settings_install_key_from_property (OGMRipSettings *settings,GObjectClass *klass,const gchar *section,const gchar *key,const gchar *property);
Installs a new key using the GParamSpec of property
.
gboolean ogmrip_settings_parse (OGMRipSettings *settings,const gchar *filename,OGMRipParseFunc func,gpointer user_data,GError **error);
Parses the settings in filename
, calling func
for each entries.
void ogmrip_settings_remove_key (OGMRipSettings *settings,const gchar *section,const gchar *key);
Removeѕ key
from section
.
void ogmrip_settings_remove_notify (OGMRipSettings *settings,gulong handler_id);
Remove a notification using the ID returned from ogmrip_settings_add_notify()
or ogmrip_settings_add_notify_while_alive().
void ogmrip_settings_remove_section (OGMRipSettings *settings,const gchar *section);
Removeѕ section
and all its keys and subsections.
void ogmrip_settings_set (OGMRipSettings *settings,const gchar *section,const gchar *key,...);
Sets the values associated with any number of settings in the same section.
settings |
||
section |
the section of the keys |
|
key |
the name of the first key to set |
|
... |
pointers to the value of the first key, followed by more name/pointer
groupings, followed by |
void
ogmrip_settings_set_default (OGMRipSettings *settings);
Sets the default setting manager. If settings
is NULL, the current default
setting manager is removed.
void ogmrip_settings_set_property_from_key (OGMRipSettings *settings,GObject *object,const gchar *property,const gchar *section,const gchar *key);
Sets a property of an object using the value of a settings key.
settings |
||
object |
A GObject |
|
property |
Name of the property to set |
|
section |
Section of a key |
|
key |
Name of a key |
void ogmrip_settings_set_value (OGMRipSettings *settings,const gchar *section,const gchar *key,const GValue *value);
Sets the setting named by key
in section
to value
.
settings |
||
section |
the section of the key |
|
key |
the name of the key to fetch |
|
value |
a GValue of the correct type |
void ogmrip_settings_unbind (OGMRipSettings *settings,GObject *object);
Removes the bindings associated to object
.
void ogmrip_settings_unblock (OGMRipSettings *settings,const gchar *section,const gchar *key);
Unblocks all notifications related to key
in section
. If section
is NULL, notifications
related to key
from all sections are unblocked.