## st-icon

st-icon — a simple styled icon actor

## Functions

ClutterActor * | st_icon_new ()
const gchar * | st_icon_get_icon_name ()
void | st_icon_set_icon_name ()
gint | st_icon_get_icon_size ()
void | st_icon_set_icon_size ()
void | st_icon_set_gicon ()
GIcon * | st_icon_get_gicon ()
void | st_icon_set_fallback_icon_name ()
const gchar * | st_icon_get_fallback_icon_name ()

## Properties

gchar * | fallback-icon-name | Read / Write
GIcon * | gicon | Read / Write
gchar * | icon-name | Read / Write
gint | icon-size | Read / Write

## Types and Values

#define | ST_TYPE_ICON
struct | StIcon
| StIconPrivate

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── ClutterActor
                ╰── StWidget
                    ╰── StIcon

## Implemented Interfaces

StIcon implements ClutterContainer, ClutterScriptable, ClutterAnimatable and AtkImplementorIface.

## Description

StIcon is a simple styled texture actor that displays an image from a stylesheet.

## Functions

### st_icon_new ()

    ClutterActor *
    st_icon_new (void);

Create a newly allocated StIcon

#### Returns

A newly allocated StIcon

### st_icon_get_icon_name ()

    const gchar *
    st_icon_get_icon_name (StIcon *icon);

### st_icon_set_icon_name ()

    void
    st_icon_set_icon_name (StIcon *icon,
                           const gchar *icon_name);

### st_icon_get_icon_size ()

    gint
    st_icon_get_icon_size (StIcon *icon);

Gets the size explicit size on the icon. This is not necesariily the size that the icon will actually be displayed at.

#### Parameters

icon | an icon |

#### Returns

the size explicitly set, or -1 if no size has been set

### st_icon_set_icon_size ()

    void
    st_icon_set_icon_size (StIcon *icon,
                           gint size);

Sets an explicit size for the icon.

#### Parameters

icon | an icon |
size | if positive, the new size, otherwise the size will be derived from the current style |

### st_icon_set_gicon ()

    void
    st_icon_set_gicon (StIcon *icon,
                       GIcon *gicon);

#### Parameters

icon | an icon |
gicon | a GIcon to override :icon-name. | [nullable]

### st_icon_get_gicon ()

    GIcon *
    st_icon_get_gicon (StIcon *icon);

#### Parameters

icon | an icon |

#### Returns

the override GIcon, if set, or NULL.

[transfer none]

### st_icon_set_fallback_icon_name ()

    void
    st_icon_set_fallback_icon_name (StIcon *icon,
                                    const gchar *icon_name);

### st_icon_get_fallback_icon_name ()

    const gchar *
    st_icon_get_fallback_icon_name (StIcon *icon);

## Types and Values

### ST_TYPE_ICON

    #define ST_TYPE_ICON st_icon_get_type()

### struct StIcon

    struct StIcon;

The contents of this structure are private and should only be accessed through the public API.

### StIconPrivate

    typedef struct _StIconPrivate StIconPrivate;

## Property Details

### The `“fallback-icon-name”` property

      “fallback-icon-name”       gchar *

A fallback icon name.

Flags: Read / Write

Default value: NULL

### The `“gicon”` property

      “gicon”                    GIcon *

The GIcon shown by this icon actor.

Flags: Read / Write

### The `“icon-name”` property

      “icon-name”                gchar *

An icon name.

Flags: Read / Write

Default value: NULL

### The `“icon-size”` property

      “icon-size”                gint

The size if the icon, if positive. Otherwise the size will be derived from the current style.

Flags: Read / Write

Allowed values: >= -1

Default value: -1