Top | ![]() |
![]() |
![]() |
![]() |
|
e_categories_get_list () |
|
e_categories_dup_list () |
|
e_categories_add () |
|
e_categories_remove () |
|
e_categories_exist () |
const |
e_categories_get_icon_file_for () |
|
e_categories_dup_icon_file_for () |
|
e_categories_set_icon_file_for () |
|
e_categories_is_searchable () |
|
e_categories_register_change_listener () |
|
e_categories_unregister_change_listener () |
GList * e_categories_get_list (void
);
e_categories_get_list
has been deprecated since version 3.16 and should not be used in newly-written code.
This function is not entirely thread safe. Use
e_categories_dup_list()
instead.
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.
GList * e_categories_dup_list (void
);
Returns a sorted list of all the category names currently configured.
This function is thread safe.
a sorted g_list_free()
g_free()
g_list_free_full()
[transfer full][element-type utf8]
Since: 3.16
void e_categories_add (const
,gchar *categoryconst
,gchar *unusedconst
,gchar *icon_file);
gboolean searchable
Adds a new category, with its corresponding icon, to the configuration database.
This function is thread safe.
void e_categories_remove (const
);gchar *category
Removes the given category from the configuration.
This function is thread safe.
gboolean e_categories_exist (const
);gchar *category
Checks whether the given category is available in the configuration.
This function is thread safe.
constgchar * e_categories_get_icon_file_for (const
);gchar *category
e_categories_get_icon_file_for
has been deprecated since version 3.16 and should not be used in newly-written code.
This function is not entirely thread safe. Use
e_categories_dup_icon_file_for()
instead.
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.
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
void e_categories_set_icon_file_for (const
,gchar *categoryconst
);gchar *icon_file
Sets the icon file associated with the given category.
This function is thread safe.
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
FALSE
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.
listener |
the callback to be called on any category change. |
[scope async] |
user_data |
used data passed to the |
Since: 2.24
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.
listener |
Callback to be removed. |
[scope async] |
user_data |
User data as passed with call to |
Since: 2.24