PIM CategoriesPIM Categories — API functions for PIM categories. | |
Description
Set of API functions to handle GPE PIM category data.
NOTE: currently all categories are global.
Details
struct gpe_pim_category
struct gpe_pim_category {
const gchar *name;
guint id;
};
A category
const gchar *name ; | Name of the category
|
guint id ; | Id of the category
|
gpe_pim_categories_init ()
gboolean gpe_pim_categories_init (void);
Initializes the category management framework.
Returns : | TRUE if initialisation succeed, FALSE otherwise.
|
gpe_pim_categories_list ()
GSList* gpe_pim_categories_list (void);
Returns a list of registered categories. The elements of the list are of
type gpe_pim_category
Returns : | A list of registered categories.
|
gpe_pim_category_new ()
gboolean gpe_pim_category_new (const gchar *title,
gint *id);
Adds a new category. id
title : | Name of the category to be added.
|
id : | Pointer to a gint to host the new category id. Must be allocated.
|
Returns : | TRUE if the category is added, FALSE otherwise.
|
gpe_pim_category_name ()
const gchar* gpe_pim_category_name (gint id);
Returns the name of the category with specified id
.
id : | the id of the category
|
Returns : | the name of the category
|