![]() |
![]() |
![]() |
libgnomedb Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
enum GnomeDbComponentType; GnomeDbComponentInfo; GList * gnome_db_config_get_component_list (const gchar *query
); void gnome_db_config_free_component_list (GList *list
); GdaDataModel * gnome_db_config_get_component_data_model (const gchar *query
); gchar * gnome_db_config_get_string (const gchar *path
); gint gnome_db_config_get_int (const gchar *path
); gdouble gnome_db_config_get_float (const gchar *path
); gboolean gnome_db_config_get_boolean (const gchar *path
); void gnome_db_config_set_string (const gchar *path
,const gchar *new_value
); void gnome_db_config_set_int (const gchar *path
,gint new_value
); void gnome_db_config_set_float (const gchar *path
,gdouble new_value
); void gnome_db_config_set_boolean (const gchar *path
,gboolean new_value
); void gnome_db_config_remove_section (const gchar *path
); void gnome_db_config_remove_key (const gchar *path
); gboolean gnome_db_config_has_section (const gchar *path
); gboolean gnome_db_config_has_key (const gchar *path
); GList * gnome_db_config_list_sections (const gchar *path
); GList * gnome_db_config_list_keys (const gchar *path
); void gnome_db_config_free_list (GList *list
); GList * gnome_db_config_get_data_source_list (void
); GdaDataSourceInfo * gnome_db_config_find_data_source (const gchar *name
); GdaDataSourceInfo * gnome_db_config_copy_data_source_info (GdaDataSourceInfo *src
); void gnome_db_config_free_data_source_info (GdaDataSourceInfo *info
); void gnome_db_config_free_data_source_list (GList *list
); void gnome_db_config_remove_data_source (const gchar *name
); void gnome_db_config_save_data_source (const gchar *name
,const gchar *provider
,const gchar *cnc_string
,const gchar *description
,const gchar *username
,const gchar *password
); guint gnome_db_config_add_listener (const gchar *path
,GConfClientNotifyFunc func
,gpointer user_data
); void gnome_db_config_remove_listener (guint id
); #define GNOME_DB_CONFIG_KEY_BROWSER_PANED_POSITION #define GNOME_DB_CONFIG_KEY_EDITOR_HIGHLIGHT #define GNOME_DB_CONFIG_KEY_EDITOR_SHOW_LINE_NUMBERS #define GNOME_DB_CONFIG_KEY_EDITOR_TAB_STOP
typedef enum { GNOME_DB_COMPONENT_TYPE_INVALID = -1, GNOME_DB_COMPONENT_TYPE_EXE, GNOME_DB_COMPONENT_TYPE_SHLIB, GNOME_DB_COMPONENT_TYPE_FACTORY } GnomeDbComponentType;
typedef struct { gchar *id; gchar *location; GnomeDbComponentType type; gchar *description; GList *repo_ids; gchar *username; gchar *hostname; gchar *domain; GdaParameterList *properties; } GnomeDbComponentInfo;
GList * gnome_db_config_get_component_list (const gchar *query
);
Return a list of all components currently installed in the system that match the given query (see BonoboActivation documentation). Each of the nodes in the returned GList is a GnomeDbComponentInfo. To free the returned list, call the gnome_db_config_free_component_list function.
|
condition for components to be retrieved. |
Returns : |
a GList of GnomeDbComponentInfo structures. |
GdaDataModel * gnome_db_config_get_component_data_model
(const gchar *query
);
Return a list of all components currently installed in the system that match the given query (see BonoboActivation documentation).
|
condition for components to be retrieved. |
Returns : |
a GdaDataModel object, or NULL on failure.
|
gchar * gnome_db_config_get_string (const gchar *path
);
Gets the value of the specified configuration entry as a string. You are then responsible to free the returned string
|
path to the configuration entry |
Returns : |
the value stored at the given entry |
gint gnome_db_config_get_int (const gchar *path
);
Gets the value of the specified configuration entry as an integer
|
path to the configuration entry |
Returns : |
the value stored at the given entry |
gdouble gnome_db_config_get_float (const gchar *path
);
Gets the value of the specified configuration entry as a float
|
path to the configuration entry |
Returns : |
the value stored at the given entry |
gboolean gnome_db_config_get_boolean (const gchar *path
);
Gets the value of the specified configuration entry as a boolean
|
path to the configuration entry |
Returns : |
the value stored at the given entry |
void gnome_db_config_set_string (const gchar *path
,const gchar *new_value
);
Sets the given configuration entry to contain a string
|
path to the configuration entry |
|
new value |
void gnome_db_config_set_int (const gchar *path
,gint new_value
);
Sets the given configuration entry to contain an integer
|
path to the configuration entry |
|
new value |
void gnome_db_config_set_float (const gchar *path
,gdouble new_value
);
Sets the given configuration entry to contain a float
|
path to the configuration entry |
|
new value |
void gnome_db_config_set_boolean (const gchar *path
,gboolean new_value
);
Sets the given configuration entry to contain a boolean
|
path to the configuration entry |
|
new value |
void gnome_db_config_remove_section (const gchar *path
);
Remove the given section from the configuration database
|
path to the configuration section |
void gnome_db_config_remove_key (const gchar *path
);
Remove the given entry from the configuration database
|
path to the configuration entry |
gboolean gnome_db_config_has_section (const gchar *path
);
Checks whether the given section exists in the configuration system
|
path to the configuration section |
Returns : |
TRUE if the section exists, FALSE otherwise |
gboolean gnome_db_config_has_key (const gchar *path
);
Check whether the given key exists in the configuration system
|
path to the configuration key |
Returns : |
TRUE if the entry exists, FALSE otherwise |
GList * gnome_db_config_list_sections (const gchar *path
);
Return a GList containing the names of all the sections available under the given root directory.
To free the returned value, you can use gnome_db_config_free_list
|
path for root dir |
Returns : |
a list containing all the section names |
GList * gnome_db_config_list_keys (const gchar *path
);
Returns a list of all keys that exist under the given path.
To free the returned value, you can use gnome_db_config_free_list
|
path for root dir |
Returns : |
a list containing all the key names |
void gnome_db_config_free_list (GList *list
);
Free all memory used by the given GList, which must be the return value from either gnome_db_config_list_sections and gnome_db_config_list_keys
|
list to be freed |
GList * gnome_db_config_get_data_source_list
(void
);
Retrieves information about available data sources.
Returns : |
a GList of GdaDatasourceInfo structures. |
GdaDataSourceInfo * gnome_db_config_find_data_source (const gchar *name
);
Looks for a data source given its name. The search is case insensitive.
|
name of the data source to look for. |
Returns : |
a GdaDatasourceInfo structure. |
GdaDataSourceInfo * gnome_db_config_copy_data_source_info
(GdaDataSourceInfo *src
);
Copies a GdaDataSourceInfo structure.
|
GdaDataSourceInfo to copy |
Returns : |
a copy of src .
|
void gnome_db_config_free_data_source_info
(GdaDataSourceInfo *info
);
Frees the resources allocated by a GdaDataSourceInfo.
|
the struture to deallocate. |
void gnome_db_config_free_data_source_list
(GList *list
);
Frees the list
.
|
a GList returned by gnome_db_config_get_data_source_list. |
void gnome_db_config_remove_data_source (const gchar *name
);
Removes the given data source from the GDA configuration.
|
Name for the data source to be removed. |
void gnome_db_config_save_data_source (const gchar *name
,const gchar *provider
,const gchar *cnc_string
,const gchar *description
,const gchar *username
,const gchar *password
);
Adds a new data source (or update an existing one) to the GDA configuration, based on the parameters given.
|
Name for the data source to be saved. |
|
Provider ID for the new data source. |
|
Connection string for the new data source. |
|
Description for the new data source. |
|
User name for the new data source. |
|
Password to use when authenticating username .
|
guint gnome_db_config_add_listener (const gchar *path
,GConfClientNotifyFunc func
,gpointer user_data
);
Installs a configuration listener, which is a callback function which will be called every time a change occurs on a given configuration entry.
|
configuration path to listen to. |
|
callback function. |
|
data to be passed to the callback function. |
Returns : |
the ID of the listener, which you will need for calling gda_config_remove_listener. If an error occurs, 0 is returned. |
void gnome_db_config_remove_listener (guint id
);
Removes a previously installed configuration listener.
|
the value returned from the call to gnome_db_config_add_listener |
#define GNOME_DB_CONFIG_KEY_BROWSER_PANED_POSITION "/apps/gnome-db/Browser/PanedPosition"
#define GNOME_DB_CONFIG_KEY_EDITOR_HIGHLIGHT "/apps/gnome-db/Editor/Highlight"
#define GNOME_DB_CONFIG_KEY_EDITOR_SHOW_LINE_NUMBERS "/apps/gnome-db/Editor/ShowLineNumbers"