St Reference Manual: StIcon

## StIcon StIcon — 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 ()

## Properties

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

## Types and Values

| StIcon

## 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]

## Types and Values

### StIcon

    typedef struct _StIcon StIcon;

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

## Property Details

### 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