St.IconTheme.choose_icon_for_scale

### Method

# St IconThemechoose_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`.