StBin

StBin — a simple container with one actor

Synopsis

struct              StBin;
struct              StBinClass;
StWidget *          st_bin_new                          (void);
void                st_bin_set_child                    (StBin *bin,
                                                         ClutterActor *child);
ClutterActor *      st_bin_get_child                    (StBin *bin);
void                st_bin_set_alignment                (StBin *bin,
                                                         StAlign x_align,
                                                         StAlign y_align);
void                st_bin_get_alignment                (StBin *bin,
                                                         StAlign *x_align,
                                                         StAlign *y_align);
void                st_bin_set_fill                     (StBin *bin,
                                                         gboolean x_fill,
                                                         gboolean y_fill);
void                st_bin_get_fill                     (StBin *bin,
                                                         gboolean *x_fill,
                                                         gboolean *y_fill);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----ClutterActor
               +----StWidget
                     +----StBin
                           +----StButton
                           +----StScrollView

Implemented Interfaces

StBin implements ClutterContainer, ClutterScriptable, ClutterAnimatable and AtkImplementorIface.

Properties

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

Description

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

StBin inherits from StWidget, so it is fully themable.

Details

struct StBin

struct StBin;

The StBin struct contains only private data

struct StBinClass

struct StBinClass {
};

The StBinClass struct contains only private data

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.

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

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

`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().

`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

`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

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

Property Details

The `"child"` property

  "child"                    ClutterActor*         : Read / Write

The child ClutterActor of the StBin container.

The `"x-align"` property

  "x-align"                  StAlign               : Read / Write

The horizontal alignment of the StBin child.

Default value: ST_ALIGN_MIDDLE

The `"x-fill"` property

  "x-fill"                   gboolean              : Read / Write

Whether the child should fill the horizontal allocation

Default value: FALSE

The `"y-align"` property

  "y-align"                  StAlign               : Read / Write

The vertical alignment of the StBin child.