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 |
const char* |
The name of the icon to lookup. |
|
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
fallbacks |
An array of char* |
No description available. | |
The argument can be NULL . | |
The array must be NULL -terminated. | |
The data is owned by the caller of the function. | |
Each element is a NUL terminated UTF-8 string. | |
size |
int |
Desired icon size. |
|
scale |
int |
The window scale this will be displayed on. |
|
direction |
GtkTextDirection |
Text direction the icon will be displayed in. |
|
flags |
GtkIconLookupFlags |
Flags modifying the behavior of the icon lookup. |
Return value
Returns: | GtkIconPaintable |
A |
|
The caller of the method takes ownership of the data, and is responsible for freeing it. |