IconTheme.chooseIcon

gtk.icon_info.IconInfo chooseIcon(string[] iconNames, int size, gtk.types.IconLookupFlags flags)

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.IconInfo.loadIcon]. ([gtk.icon_theme.IconTheme.loadIcon] 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.

Parameters

iconNamesnull-terminated array of icon names to lookup
sizedesired icon size
flagsflags modifying the behavior of the icon lookup

Returns

a #GtkIconInfo object

containing information about the icon, or null if the icon wasn’t found.