Engine
Object Hierarchy:
Description:
An opaque data type representing one or more configuration sources.
Namespace: GConf
Package: gconf-2.0
Content:
Static methods:
-
public static weak Engine get_default ()
Returns the default Engine. All clients should use this,
unless they are special configuration-related tools. The caller of this function assumes one reference count, and must call
gconf_engine_unref at some point. It's fairly important to unref the Engine, to
cleanly close the connection to gconfd. So if possible close the connection before exiting your application.
-
public static weak Engine get_for_address (string address) throws Error
-
public static weak Engine get_for_addresses (SList<string> addresses) throws Error
Methods:
-
public SList<string> all_dirs (string dir) throws Error
Lists the subdirectories in dir. The returned list contains allocated strings. Each string
is the absolute path of a subdirectory. You should g_free each string in the
list, then g_slist_free the list itself.
-
public SList<Entry> all_entries (string dir) throws Error
Lists the key-value pairs in dir. Does not list subdirectories; for that use
all_dirs. The returned list contains
Entry objects. A Entry contains an absolute key and a value. The list
is not recursive, it contains only the immediate children of dir. To free the returned list, gconf_entry_free
each list element, then g_slist_free the list itself.
-
public bool associate_schema (string key, string schema_key) throws Error
-
public weak ChangeSet change_set_from_current (...) throws Error
-
public weak ChangeSet change_set_from_currentv (string keys) throws Error
-
public bool commit_change_set (ChangeSet cs, bool remove_committed) throws Error
-
public bool dir_exists (string dir) throws Error
-
public unowned Value get (string key) throws Error
-
public bool get_bool (string key) throws Error
-
public unowned Value get_default_from_schema (string key) throws Error
-
public weak Entry get_entry (string key, string locale, bool use_schema_default) throws Error
-
public double get_float (string key) throws Error
-
public int get_int (string key) throws Error
-
public SList get_list (string key, ValueType list_type) throws Error
-
public bool get_pair (string key, ValueType car_type, ValueType cdr_type, void* car_retloc, void* cdr_retloc) throws Error
-
public unowned Schema get_schema (string key) throws Error
-
public unowned string get_string (string key) throws Error
-
public void* get_user_data ()
-
public unowned Value get_with_locale (string key, string locale) throws Error
-
public unowned Value get_without_default (string key) throws Error
-
public bool key_is_writable (string key) throws Error
-
public uint notify_add (string namespace_section, NotifyFunc func) throws Error
Registers a notification request with the gconfd server. The server will notify the client
when any key at or below namespace_section is set or unset. Try to watch the smallest possible part of the namespace;
otherwise you will slow down the server and your application with unnecessary notifications. Note that you should prefer
notify_add if you're using the
Object wrapper library, because
notify_add does not require a client-server conversation for every callback.
notify_add requests a different server notification for every callback. The
function returns an ID you can use to remove the notification request; 0 is an invalid ID, and is returned if an error occurs.
-
public void notify_remove (uint cnxn)
-
public void remove_dir (string dir) throws Error
-
public weak ChangeSet reverse_change_set (ChangeSet cs) throws Error
-
public bool set (string key, Value value) throws Error
-
public bool set_bool (string key, bool val) throws Error
-
public bool set_float (string key, double val) throws Error
-
public bool set_int (string key, int val) throws Error
-
public bool set_list (string key, ValueType list_type, SList list) throws Error
-
public bool set_pair (string key, ValueType car_type, ValueType cdr_type, void* address_of_car, void* address_of_cdr) throws Error
-
public bool set_schema (string key, Schema val) throws Error
-
public bool set_string (string key, string val) throws Error
-
public void set_user_data (void* data, DestroyNotify dnotify)
-
public void suggest_sync () throws Error
-
public bool unset (string key) throws Error