![]() |
![]() |
![]() |
GConf Bridge Reference Manual | |
---|---|---|---|---|
void gconf_bridge_install_default_error_handler (void); GConfBridge; GConfBridge* gconf_bridge_get (void); GConfClient* gconf_bridge_get_client (GConfBridge *bridge); guint gconf_bridge_bind_property_full (GConfBridge *bridge, const char *key, GObject *object, const char *prop, gboolean delayed_sync); #define gconf_bridge_bind_property (bridge, key, object, prop) #define gconf_bridge_bind_property_delayed (bridge, key, object, prop) guint gconf_bridge_bind_window (GConfBridge *bridge, const char *key_prefix, GtkWindow *window, gboolean bind_size, gboolean bind_pos); #define gconf_bridge_bind_window_size (bridge, key_prefix, window) #define gconf_bridge_bind_window_pos (bridge, key_prefix, window) guint gconf_bridge_bind_string_list_store (GConfBridge *bridge, const char *key, GtkListStore *list_store); void gconf_bridge_unbind (GConfBridge *bridge, guint binding_id);
void gconf_bridge_install_default_error_handler (void);
Sets up the default error handler. Any unhandled GConf errors will automatically be handled by presenting the user an error dialog.
typedef struct _GConfBridge GConfBridge;
GConfBridge is an opaque type, there are no publicly accessible members.
GConfBridge* gconf_bridge_get (void);
Returns the GConfBridge. This is a singleton object.
Returns : |
The GConfBridge. |
GConfClient* gconf_bridge_get_client (GConfBridge *bridge);
Returns the GConfClient used by bridge
. This is the same GConfClient
as returned by gconf_client_get_default()
.
|
A GConfBridge |
Returns : |
A GConfClient. |
guint gconf_bridge_bind_property_full (GConfBridge *bridge, const char *key, GObject *object, const char *prop, gboolean delayed_sync);
Binds key
to prop
, causing them to have the same value at all times.
The types of key
and prop
should be compatible. Floats and doubles, and
ints, uints, longs, unlongs, int64s, uint64s, chars, uchars and enums
can be matched up. Booleans and strings can only be matched to their
respective types.
On calling this function the current value of key
will be set to prop
.
|
A GConfBridge |
|
A GConf key to be bound |
|
A GObject |
|
The property of object to be bound
|
|
TRUE if there should be a delay between property changes and syncs to GConf. Set to TRUE when binding to a rapidly-changing property, for example the "value" property on a GtkAdjustment. |
Returns : |
The ID of the new binding. |
#define gconf_bridge_bind_property(bridge, key, object, prop)
Binds key
to prop
without delays, causing them to have the same value at all times. See
gconf_bridge_bind_property_full for more details.
|
A GConfBridge |
|
A GConf key to be bound |
|
A GObject |
|
The property of object to be bound
|
#define gconf_bridge_bind_property_delayed(bridge, key, object, prop)
Binds key
to prop
with a delay, causing them to have the same value at all
times. See gconf_bridge_bind_property_full for more details.
|
A GConfBridge |
|
A GConf key to be bound |
|
A GObject |
|
The property of object to be bound
|
guint gconf_bridge_bind_window (GConfBridge *bridge, const char *key_prefix, GtkWindow *window, gboolean bind_size, gboolean bind_pos);
On calling this function window
will be resized to the values
specified by "key_prefix
_width" and "key_prefix
_height" if
bind_size
is TRUE, and moved to the values specified by
"key_prefix
_x" and "key_prefix
_y" if bind_pos
is TRUE.
The respective GConf values will be updated when the window is resized
and/or moved.
|
A GConfBridge |
|
The prefix of the GConf keys |
|
A GtkWindow |
|
TRUE to bind the size of window
|
|
TRUE to bind the position of window
|
Returns : |
The ID of the new binding. |
#define gconf_bridge_bind_window_size(bridge, key_prefix, window)
On calling this function window
will be resized to the values specified by
"key_prefix
_width" and "key_prefix
_height". The respective
GConf values will be updated when the window is resized. See
gconf_bridge_bind_window for more details.
|
A GConfBridge |
|
The prefix of the GConf keys |
|
A GtkWindow |
#define gconf_bridge_bind_window_pos(bridge, key_prefix, window)
On calling this function window
will be moved to the values specified by
"key_prefix
_x" and "key_prefix
_y". The respective GConf
values will be updated when the window is moved. See
gconf_bridge_bind_window for more details.
|
A GConfBridge |
|
The prefix of the GConf keys |
|
A GtkWindow |
guint gconf_bridge_bind_string_list_store (GConfBridge *bridge, const char *key, GtkListStore *list_store);
On calling this function single string column GtkListStore list_store
will be kept synchronized with the GConf string list value pointed to by
key
. On calling this function list_store
will be populated with the
strings specified by the value of key
.
|
A GConfBridge |
|
A GConf key to be bound |
|
A GtkListStore |
Returns : |
The ID of the new binding. |
void gconf_bridge_unbind (GConfBridge *bridge, guint binding_id);
Removes the binding with ID binding_id
.
|
A GConfBridge |
|
The ID of the binding to be removed |