e_categories_get_list ()

GList *
e_categories_get_list (void);

Returns a sorted list of all the category names currently configured.

This function is mostly thread safe, but as the category names are not copied, they may be freed by another thread after being returned by this function. Use e_categories_dup_list() instead.

e_categories_dup_list ()

GList *
e_categories_dup_list (void);

Returns a sorted list of all the category names currently configured.

This function is thread safe.

Since: 3.16

e_categories_add ()

void
e_categories_add (const gchar *category,
                  const gchar *unused,
                  const gchar *icon_file,
                  gboolean searchable);

Adds a new category, with its corresponding icon, to the configuration database.

This function is thread safe.

e_categories_remove ()

void
e_categories_remove (const gchar *category);

Removes the given category from the configuration.

This function is thread safe.

e_categories_exist ()

gboolean
e_categories_exist (const gchar *category);

Checks whether the given category is available in the configuration.

This function is thread safe.

e_categories_get_icon_file_for ()

const gchar *
e_categories_get_icon_file_for (const gchar *category);

Gets the icon file associated with the given category.

This function is mostly thread safe, but as the icon file name is not copied, it may be freed by another thread after being returned by this function. Use e_categories_dup_icon_file_for() instead.

e_categories_dup_icon_file_for ()

gchar *
e_categories_dup_icon_file_for (const gchar *category);

Gets the icon file associated with the given category and returns a copy of it.

This function is thread safe.

Since: 3.16

e_categories_set_icon_file_for ()

void
e_categories_set_icon_file_for (const gchar *category,
                                const gchar *icon_file);

Sets the icon file associated with the given category.

This function is thread safe.

e_categories_is_searchable ()

gboolean
e_categories_is_searchable (const gchar *category);

Gets whether the given calendar is to be used for searches in the GUI.

This function is thread safe.

Return value; TRUE% if the category is searchable, FALSE% if not.

e_categories_register_change_listener ()

void
e_categories_register_change_listener (GCallback listener,
                                       gpointer user_data);

Registers callback to be called on change of any category. Pair listener and user_data is used to distinguish between listeners. Listeners can be unregistered with e_categories_unregister_change_listener .

This function is thread safe.

Since: 2.24

e_categories_unregister_change_listener ()

void
e_categories_unregister_change_listener
                               (GCallback listener,
                                gpointer user_data);

Removes previously registered callback from the list of listeners on changes. If it was not registered, then does nothing.

This function is thread safe.

Since: 2.24