![]() |
![]() |
![]() |
GPE Manual: libgpepimc Reference | ![]() |
---|---|---|---|---|
struct gpe_pim_category; gboolean gpe_pim_categories_init (void); GSList* gpe_pim_categories_list (void); gboolean gpe_pim_category_new (const gchar *title, gint *id); const gchar* gpe_pim_category_name (gint id);
Set of API functions to handle GPE PIM category data. NOTE: currently all categories are global.
struct gpe_pim_category { const gchar *name; guint id; const gchar *colour; };
A category
const gchar *name ; |
Name of the category |
guint id ; |
Id of the category |
const gchar *colour ; |
Colour assigned to identify this category in GUI applications |
gboolean gpe_pim_categories_init (void);
Initializes the category management framework.
Returns : | TRUE if initialisation succeed, FALSE otherwise. |
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. |
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. |