GridLayout

Widget
     ->Layout
          ->GridLayout

Description

GridLayout lays out its child widgets in a flexible grid, where each widget occupies some cell in its upper-left corner and then spans some * number of rows and columns.
Attributes
fillVert
    If true, the widget will expand vertically to fit any extra room allocated to it. The default is false, so the widget will tend to keep its natural size.
    Default Value:

columns
    The number of columns in the grid. See rows.
    Default Value:

column
    The column in which to place the child. By default, if the columns attribute is set for the GridLayout and the last widget was placed in the rightmost column, this one will be placed in the next row in the first column (that is, the widget will "wrap" to the next row); if the last widget was not in the rightmost column, or the columns attribute is not given, this widget will be placed immediately to the right of the last.
    Default Value:

marginTop
    The amount of space between the top of the widget and the bounding box of its cell in the grid.
    Default Value:

marginRight
    The amount of space between the right side of the widget and the bounding box of its cell in the grid.
    Default Value:

marginBottom
    The amount of space between the bottom of the widget and the bounding box of its cell in the grid.
    Default Value:

row
    The row in which to place the child. By default, if the columns attribute is set for the GridLayout and the last widget was placed in the rightmost column, this one will be placed in the next row; if the last widget was not in the rightmost column, or the columns attribute is not given, this widget will be placed in the same row as the last.
    Default Value:

alignVert
    The vertical alignment of the widget. Should be "top", "center", or "bottom". The default is "center".
    Default Value:

gapVert
    The default vertical gap between child widgets. See gapHoriz.
    Default Value:

weightVert
    The vertical weight of the widget. Should be a real number between 0.0 and 1.0. See weightHoriz.
    Default Value:

fillHoriz
    If true, the widget will expand horizontally to fit any extra room allocated to it. The default is false, so the widget will tend to keep its natural size.
    Default Value:

rows
    The number of rows in the grid. By default, the grid has as many rows and columns as are needed to accomodate its child widgets. If explicit dimensions of the grid are given, the GridLayout will, by default, automatically place child widgets from left to right and top to bottom.
    Default Value:

paddingHeight
    The amount of extra space to put in each of the top and bottom gutters adjacent to the widget's cell in the grid, between the cell and the neighboring cells.
    Default Value:

gapHoriz
    The default horizontal gap between child widgets. Can be overridden for particular children by using the paddingLeft and paddingRight child attributes.
    Default Value:

spanColumns
    The number of columns spanned by the widget, or alternatively the width of the widget in rows. Note that if spanColumns is set for a widget, it may overlap with the next widget placed if row and column attributes are not given. (The automatic placement algorithm does not take span into account.)

By default, each widget takes up a single cell; that is, spanRows == spanColumns == 1.
    Default Value:

alignHoriz
    The horizontal alignment of the widget. Should be "left", "center", or "right". The default is "center".
    Default Value:

spanRows
    The number of rows spanned by the widget, or alternatively the height of the widget in rows. Note that if spanRows is set for a widget, it may overlap with a widget placed below it if explicit row and column attributes are not given. (The automatic placement algorithm does not take span into account.)

By default, each widget takes up a single cell; that is, spanRows == spanColumns == 1.
    Default Value:

marginLeft
    The amount of space between the left side of the widget and the bounding box of its cell in the grid.
    Default Value:

weightHoriz
    The horizontal weight of the widget. Should be a real number between 0.0 and 1.0. If there is extra space in the grid after all widgets are placed, the remaining space is allocated in proportion to the weights of the widgets. The default is 1.0, but see fillHoriz.
    Default Value:

paddingWidth
    The amount of extra space to put in each of the left and right gutters next to the widget's cell in the grid, between the cell and the neighboring cells.
    Default Value: