Method
GtkIconThemechoose_icon_for_scale
since: 3.10
Declaration [src]
GtkIconInfo*
gtk_icon_theme_choose_icon_for_scale (
GtkIconTheme* icon_theme,
const gchar** icon_names,
gint size,
gint scale,
GtkIconLookupFlags flags
)
Description [src]
Looks up a named icon for a particular window scale and returns
a GtkIconInfo
containing information such as the filename of the
icon. The icon can then be rendered into a pixbuf using
gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon()
combines these two steps if all you need is the pixbuf.)
If icon_names
contains more than one name, this function
tries them all in the given order before falling back to
inherited icon themes.
Available since: 3.10
Parameters
icon_names
-
Type: An array of
gchar*
NULL
-terminated array of icon names to lookup.The array must be NULL
-terminated.The data is owned by the caller of the method. Each element is a NUL terminated UTF-8 string. size
-
Type:
gint
Desired icon size.
scale
-
Type:
gint
Desired scale.
flags
-
Type:
GtkIconLookupFlags
Flags modifying the behavior of the icon lookup.
Return value
Type: GtkIconInfo
A GtkIconInfo
object
containing information about the icon, or NULL
if the
icon wasn’t found.
The caller of the method takes ownership of the data, and is responsible for freeing it. |
The return value can be NULL . |