StBin

StBin — a simple container with one actor

Functions

StWidget * st_bin_new ()
void st_bin_set_child ()
ClutterActor * st_bin_get_child ()
void st_bin_set_alignment ()
void st_bin_get_alignment ()
void st_bin_set_fill ()
void st_bin_get_fill ()

Properties

ClutterActor * child Read / Write
StAlign x-align Read / Write
gboolean x-fill Read / Write
StAlign y-align Read / Write
gboolean y-fill Read / Write

Types and Values

struct StBin
struct StBinClass

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── ClutterActor
            ╰── StWidget
                ╰── StBin
                    ├── StButton
                    ╰── StScrollView

Implemented Interfaces

StBin implements ClutterContainer, ClutterScriptable, ClutterAnimatable and AtkImplementorIface.

Description

StBin is a simple container capable of having only one ClutterActor as a child.

StBin inherits from StWidget, so it is fully themable.

Functions

st_bin_new ()

StWidget *
st_bin_new (void);

Creates a new StBin, a simple container for one child.

Returns

the newly created StBin actor


st_bin_set_child ()

void
st_bin_set_child (StBin *bin,
                  ClutterActor *child);

Sets child as the child of bin .

If bin already has a child, the previous child is removed.

Parameters

bin

a StBin

 

child

a ClutterActor, or NULL.

[allow-none]

st_bin_get_child ()

ClutterActor *
st_bin_get_child (StBin *bin);

Retrieves a pointer to the child of bin .

Parameters

bin

a StBin

 

Returns

a ClutterActor, or NULL.

[transfer none]


st_bin_set_alignment ()

void
st_bin_set_alignment (StBin *bin,
                      StAlign x_align,
                      StAlign y_align);

Sets the horizontal and vertical alignment of the child inside a StBin.

Parameters

bin

a StBin

 

x_align

horizontal alignment

 

y_align

vertical alignment

 

st_bin_get_alignment ()

void
st_bin_get_alignment (StBin *bin,
                      StAlign *x_align,
                      StAlign *y_align);

Retrieves the horizontal and vertical alignment of the child inside a StBin, as set by st_bin_set_alignment().

Parameters

bin

a StBin

 

x_align

return location for the horizontal alignment, or NULL

 

y_align

return location for the vertical alignment, or NULL

 

st_bin_set_fill ()

void
st_bin_set_fill (StBin *bin,
                 gboolean x_fill,
                 gboolean y_fill);

Sets whether the child of bin should fill out the horizontal and/or vertical allocation of the parent

Parameters

bin

a StBin

 

x_fill

TRUE if the child should fill horizontally the bin

 

y_fill

TRUE if the child should fill vertically the bin

 

st_bin_get_fill ()

void
st_bin_get_fill (StBin *bin,
                 gboolean *x_fill,
                 gboolean *y_fill);

Retrieves the horizontal and vertical fill settings

Parameters

bin

a StBin

 

x_fill

return location for the horizontal fill, or NULL.

[out]

y_fill

return location for the vertical fill, or NULL.

[out]

Types and Values

struct StBin

struct StBin;

The StBin struct contains only private data


struct StBinClass

struct StBinClass {
};

The StBinClass struct contains only private data

Property Details

The “child” property

  “child”                    ClutterActor *

The child ClutterActor of the StBin container.

Owner: StBin

Flags: Read / Write


The “x-align” property

  “x-align”                  StAlign

The horizontal alignment of the StBin child.

Owner: StBin

Flags: Read / Write

Default value: ST_ALIGN_MIDDLE


The “x-fill” property

  “x-fill”                   gboolean

Whether the child should fill the horizontal allocation

Owner: StBin

Flags: Read / Write

Default value: FALSE


The “y-align” property

  “y-align”                  StAlign

The vertical alignment of the StBin child.

Owner: StBin

Flags: Read / Write

Default value: ST_ALIGN_MIDDLE


The “y-fill” property

  “y-fill”                   gboolean

Whether the child should fill the vertical allocation

Owner: StBin

Flags: Read / Write

Default value: FALSE