## StTable

StTable — A multi-child layout container based on rows and columns

## Synopsis

    struct              StTable;
    enum                StTableChildOptions;
    struct              StTableClass;
    gint                st_table_get_column_count           (StTable *table);
    gint                st_table_get_row_count              (StTable *table);
    StWidget *          st_table_new                        (void);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----ClutterActor
                   +----StWidget
                         +----StContainer
                               +----StTable

## Implemented Interfaces

StTable implements ClutterScriptable, ClutterAnimatable, AtkImplementorIface and ClutterContainer.

## Properties

      "column-count"             gint                  : Read
      "homogeneous"              gboolean              : Read / Write
      "row-count"                gint                  : Read

## Description

StTable is a mult-child layout container based on a table arrangement with rows and columns. StTable adds several child properties to it's children that control their position and size in the table.

## Details

### struct StTable

    struct StTable;

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

### enum StTableChildOptions

    typedef enum {
      ST_KEEP_ASPECT_RATIO = 1 << 0,
      ST_X_EXPAND          = 1 << 1,
      ST_Y_EXPAND          = 1 << 2,
      ST_X_FILL            = 1 << 3,
      ST_Y_FILL            = 1 << 4
    } StTableChildOptions;

Denotes the child properties an StTable child will have.

`ST_KEEP_ASPECT_RATIO` | whether to respect the widget's aspect ratio
`ST_X_EXPAND` | whether to allocate extra space on the widget's x-axis
`ST_Y_EXPAND` | whether to allocate extra space on the widget's y-axis
`ST_X_FILL` | whether to stretch the child to fill the cell horizontally
`ST_Y_FILL` | whether to stretch the child to fill the cell vertically

### struct StTableClass

    struct StTableClass {
      StContainerClass parent_class;
    };

### st_table_get_column_count ()

    gint                st_table_get_column_count           (StTable *table);

Retrieve the current number of columns in `table`

`table` : | A StTable
Returns : | the number of columns

### st_table_get_row_count ()

    gint                st_table_get_row_count              (StTable *table);

Retrieve the current number rows in the `table`

`table` : | A StTable
Returns : | the number of rows

### st_table_new ()

    StWidget *          st_table_new                        (void);

Create a new StTable

Returns : | a new StTable

## Property Details

### The `"column-count"` property

      "column-count"             gint                  : Read

The number of columns in the table.

Allowed values: >= 0

Default value: 0

### The `"homogeneous"` property

      "homogeneous"              gboolean              : Read / Write

Homogeneous rows and columns.

Default value: TRUE

### The `"row-count"` property

      "row-count"                gint                  : Read

The number of rows in the table.

Allowed values: >= 0

Default value: 0