Method

StIconThemechoose_icon_for_scale

Declaration [src]

StIconInfo*
st_icon_theme_choose_icon_for_scale (
  StIconTheme* icon_theme,
  const char** icon_names,
  int size,
  int scale,
  StIconLookupFlags flags
)

Description [src]

Looks up a named icon for a particular window scale and returns a StIconInfo containing information such as the filename of the icon. The icon can then be rendered into a pixbuf using st_icon_info_load_icon(). (st_icon_theme_load_icon() 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

icon_names

Type: An array of char*

NULL-terminated array of icon names to lookup.

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: int

Desired icon size.

scale

Type: int

Desired scale.

flags

Type: StIconLookupFlags

Flags modifying the behavior of the icon lookup.

Return value

Type: StIconInfo

A StIconInfo object containing information about the icon.

The caller of the method takes ownership of the returned data, and is responsible for freeing it.
The return value can be NULL.