Method

GtkIconThemelist_icons

since: 2.4

Declaration [src]

GList*
gtk_icon_theme_list_icons (
  GtkIconTheme* icon_theme,
  const gchar* context
)

Description [src]

Lists the icons in the current icon theme. Only a subset of the icons can be listed by providing a context string. The set of values for the context string is system dependent, but will typically include such values as “Applications” and “MimeTypes”. Contexts are explained in the Icon Theme Specification. The standard contexts are listed in the Icon Naming Specification. Also see gtk_icon_theme_list_contexts().

Available since: 2.4

Parameters

context

Type: const gchar*

A string identifying a particular type of icon, or NULL to list all icons.

The argument can be NULL.

The data is owned by the caller of the method.

The value is a NUL terminated UTF-8 string.

Return value

Type: A list of utf8

A GList list holding the names of all the icons in the theme. You must first free each element in the list with g_free(), then free the list itself with g_list_free().

The caller of the method takes ownership of the returned data, and is responsible for freeing it.

Each element is a NUL terminated UTF-8 string.