Method
GtkIconThemelookup_icon
Declaration [src]
GtkIconPaintable*
gtk_icon_theme_lookup_icon (
GtkIconTheme* self,
const char* icon_name,
const char** fallbacks,
int size,
int scale,
GtkTextDirection direction,
GtkIconLookupFlags flags
)
Description [src]
Looks up a named icon for a desired size and window scale,
returning a GtkIconPaintable.
The icon can then be rendered by using it as a GdkPaintable,
or you can get information such as the filename and size.
If the available icon_name is not available and fallbacks are
provided, they will be tried in order.
If no matching icon is found, then a paintable that renders the
“missing icon” icon is returned. If you need to do something else
for missing icons you need to use gtk_icon_theme_has_icon().
Note that you probably want to listen for icon theme changes and update the icon. This is usually done by overriding the GtkWidgetClass.css-changed() function.
Parameters
icon_name-
Type:
const char*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. fallbacks-
Type: An array of
char*Fallback names.
The argument can be NULL.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:
intDesired icon size, in application pixels.
scale-
Type:
intThe window scale this will be displayed on.
direction-
Type:
GtkTextDirectionText direction the icon will be displayed in.
flags-
Type:
GtkIconLookupFlagsFlags modifying the behavior of the icon lookup.
Return value
Type: GtkIconPaintable
A GtkIconPaintable object
containing the icon.
| The caller of the method takes ownership of the returned data, and is responsible for freeing it. |