Method
GtkIconThemelookup_icon
since: 2.4
Declaration [src]
GtkIconInfo*
gtk_icon_theme_lookup_icon (
GtkIconTheme* icon_theme,
const gchar* icon_name,
gint size,
GtkIconLookupFlags flags
)
Description [src]
Looks up a named icon 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.)
When rendering on displays with high pixel densities you should not
use a size multiplied by the scaling factor returned by functions
like gdk_window_get_scale_factor(). Instead, you should use
gtk_icon_theme_lookup_icon_for_scale(), as the assets loaded
for a given scaling factor may be different.
Available since: 2.4
Parameters
icon_name-
Type:
const gchar*The name of the icon to lookup.
The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. size-
Type:
gintDesired icon size.
flags-
Type:
GtkIconLookupFlagsFlags 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 returned data, and is responsible for freeing it. |
The return value can be NULL. |