| IBus Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Signals | ||||
IBusConfig; IBusConfigClass; IBusConfig * ibus_config_new (IBusConnection *connection); gboolean ibus_config_get_value (IBusConfig *config,const gchar *section,const gchar *name,GValue *value); gboolean ibus_config_set_value (IBusConfig *config,const gchar *section,const gchar *name,const GValue *value); gboolean ibus_config_unset (IBusConfig *config,const gchar *section,const gchar *name);
An IBusConfig provides engine configuration methods such as get and set the configure settings to configuration file.
Currently, IBusConfig supports gconf.
IBusConfig * ibus_config_new (IBusConnection *connection);
New a IBusConfig from existing IBusConnection.
|
An IBusConnection. |
Returns : |
An newly allocated IBusConfig corresponding to connection.
|
gboolean ibus_config_get_value (IBusConfig *config,const gchar *section,const gchar *name,GValue *value);
Get the value of a configuration option.
GConf stores configure options in a tree-like structure,
and the IBus related setting is at /desktop/ibus,
thus, section here is a path from there,
while name is the key of that configuration option.
ibus-chewing, for example, stores its setting in /desktop/ibus/engine/Chewing,
so the section name for it is "engine/Chewing".
see_also: ibus_config_set_value.
|
An IBusConfig |
|
Section name of the configuration option. |
|
Name of the configure option. |
|
GValue that holds the value. |
Returns : |
TRUE if succeed; FALSE otherwise. |
gboolean ibus_config_set_value (IBusConfig *config,const gchar *section,const gchar *name,const GValue *value);
Set the value of a configuration option.
see_also: ibus_config_get_value.
|
An IBusConfig |
|
Section name of the configuration option. |
|
Name of the configure option its self. |
|
GValue that holds the value. |
Returns : |
TRUE if succeed; FALSE otherwise. |
gboolean ibus_config_unset (IBusConfig *config,const gchar *section,const gchar *name);
Remove an entry of a configuration option.
see_also: ibus_config_get_value.
|
An IBusConfig |
|
Section name of the configuration option. |
|
Name of the configure option its self. |
Returns : |
TRUE if succeed; FALSE otherwise. |
"value-changed" signalvoid user_function (IBusConfig *config, gchar *section, gchar *name, GValue *value, gpointer user_data) : Run Last
Emitted when configuration value is changed.
Argument user_data is ignored in this function.
|
An IBusConfig. |
|
Section name. |
|
Name of the property. |
|
Value. |
|
user data set when the signal handler was connected. |