gtk-icon-theme-choose-icon (theme names size flags)

theme -- a gtk-icon-theme object
names -- list of strings with the icon names to lookup
size -- an integer with the desired icon size
flags -- a gtk-icon-lookup-flags value modifying the behavior of the icon lookup

A gtk-icon-info instance containing information about the icon, or nil if the icon was not found.

Looks up a named icon and returns a gtk-icon-info instance containing information such as the filename of the icon. The icon can then be rendered into a pixbuf using the gtk-icon-info-load-icon function. The gtk-icon-theme-load-icon function combines these two steps if all you need is the pixbuf.

If the names argument contains more than one name, this function tries them all in the given order before falling back to inherited icon themes.