## StLabel StLabel — Widget for displaying text |

## Synopsis

    struct              StLabel;
    struct              StLabelClass;
    ClutterActor *      st_label_get_clutter_text           (StLabel *label);
    const gchar *       st_label_get_text                   (StLabel *label);
    StWidget *          st_label_new                        (const gchar *text);
    void                st_label_set_text                   (StLabel *label,
                                                             const gchar *text);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----ClutterActor
                   +----StWidget
                         +----StLabel

## Implemented Interfaces

StLabel implements ClutterScriptable, ClutterAnimatable and AtkImplementorIface.

## Properties

      "clutter-text"             ClutterText*          : Read
      "text"                     gchar*                : Read / Write

## Description

StLabel is a simple widget for displaying text. It derives from StWidget to add extra style and placement functionality over ClutterText. The internal ClutterText is publicly accessibly to allow applications to set further properties.

## Details

### struct StLabel

    struct StLabel;

The contents of this structure is private and should only be accessed using the provided API.

### struct StLabelClass

    struct StLabelClass {
      StWidgetClass parent_class;
    };

### st_label_get_clutter_text ()

    ClutterActor *      st_label_get_clutter_text           (StLabel *label);

Retrieve the internal ClutterText so that extra parameters can be set

`label` : | a StLabel
Returns : | ethe ClutterText used by StLabel. The label is owned by the StLabel and should not be unref'ed by the application. [transfer none]

### st_label_get_text ()

    const gchar *       st_label_get_text                   (StLabel *label);

Get the text displayed on the label

`label` : | a StLabel
Returns : | the text for the label. This must not be freed by the application

### st_label_new ()

    StWidget *          st_label_new                        (const gchar *text);

Create a new StLabel with the specified label

`text` : | text to set the label to
Returns : | a new StLabel

### st_label_set_text ()

    void                st_label_set_text                   (StLabel *label,
                                                             const gchar *text);

Sets the text displayed on the label

`label` : | a StLabel
`text` : | text to set the label to

## Property Details

### The `"clutter-text"` property

      "clutter-text"             ClutterText*          : Read

Internal ClutterText actor.

### The `"text"` property

      "text"                     gchar*                : Read / Write

Text of the label.

Default value: NULL