St.IconTheme.lookup_by_gicon

### Method

# St IconThemelookup_by_gicon

#### Declaration [src]

    StIconInfo*
    st_icon_theme_lookup_by_gicon (
      StIconTheme* icon_theme,
      GIcon* icon,
      int size,
      StIconLookupFlags flags
    )

#### Description [src]

Looks up an icon 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()`.

When rendering on displays with high pixel densities you should not use a `size` multiplied by the scaling factor returned by functions like gdk_window_get_scale_factor(). Instead, you should use `st_icon_theme_lookup_by_gicon_for_scale()`, as the assets loaded for a given scaling factor may be different.

#### Parameters

`icon`

  Type: `GIcon`

  The `GIcon` to look up.

  The data is owned by the caller of the method.

`size`

  Type: `int`

  Desired icon size.

`flags`

  Type: `StIconLookupFlags`

  Flags modifying the behavior of the icon lookup.

#### Return value

Type: `StIconInfo`

A `StIconInfo` 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`.