gtk.Table — layout widgets in a two-dimensional array
| class gtk.Table(gtk.Container): | 
| 
 | 
| 
 | 
The gtk.Table manages a
group of widgets that are arranged in rows and columns, making it easy to
align many widgets next to each other, horizontally and vertically. Tables
are created with a call to gtk.Table(). The size of a table can
be changed using the resize()
method.
Widgets can be added to a table using the attach()
method. To alter the space of the row next to a specific row, use the set_row_spacing() 
method, and for a column, the set_col_spacing() 
method. The gaps between all rows or columns can be changed by calling the
set_row_spacings() 
or set_col_spacings() 
methods respectively. The set_homogeneous() 
method changes the setting that determines whether all cells in the table
will resize themselves to the size of the largest widget in the
table.
    gtk.Table(rows=1, columns=1, homogeneous=False)| 
 | the number of rows | 
| 
 | the number of columns | 
| 
 | if Trueall table cells will
be the same size as the largest cell | 
| Returns : | a new gtk.Tablewidget | 
Creates a new gtk.Table widget with
the number of rows and columns specified by the value of
rows and columns respectively.
The value of rows and columns
must be in the range 0 .. 65535. If homogeneous is
True the table cells will all be the same size as the
largest cell. If rows or
columns are not specified they default to 1.
    def resize(rows, columns)| 
 | The new number of rows. | 
| 
 | The new number of columns. | 
The resize() method changes the size of
the table as specified by the parameters, rows and
columns.
    def attach(child, left_attach, right_attach, top_attach, bottom_attach, xoptions=gtk.EXPAND|gtk.FILL, yoptions=gtk.EXPAND|gtk.FILL, xpadding=0, ypadding=0)| 
 | the widget to add. | 
| 
 | the column number to attach the left side of a child widget to. | 
| 
 | the column number to attach the right side of a child widget to. | 
| 
 | the row number to attach the top side of a child widget to. | 
| 
 | the row number to attach the bottom side of a child widget to. | 
| 
 | used to specify the properties of the child widget when the table is resized horizontally. | 
| 
 | used to specify the properties of the child widget when the table is resized vertically. | 
| 
 | the amount of padding to add on the left and right of the widget | 
| 
 | the amount of padding to add above and below the widget | 
The attach() method adds the widget
specified by child to the table. The number of
'cells' that a widget will occupy is specified by:
left_attach - the column to the
left of the widgetright_attach - the column to the
right of the widgettop_attach - the row above the
widget andbottom_attach - the row below the
widgetThe xoptions and
yoptions determine the expansion properties of the
widget in the horizontal and vertical directions respectively (the default
value is gtk.FILL|gtk.EXPAND). The
value of the options is a combination of:
| 
 | the table cell should expand to take up any extra space that has been allocated to the table. | 
| 
 | the widget should shrink when the table cell shrinks. | 
| 
 | the widget should fill the space allocated to it in the table cell. | 
The xpadding and ypadding parameters determine the extra padding added around the widget. By default these are 0.
    def set_row_spacing(row, spacing)| 
 | the row number whose spacing will be changed. | 
| 
 | the number of pixels of added spacing | 
The set_row_spacing() method sets the
spacing in pixels (specified by spacing) between the
specified row and the following row.
    def get_row_spacing(row)| 
 | a row in the table, 0 indicates the first row | 
| Returns : | the row spacing | 
The get_row_spacing() method returns
the amount of space between the specified row, and
the following row. See the set_row_spacing() 
method.
    def set_col_spacing(column, spacing)| 
 | the column number whose spacing will be changed. | 
| 
 | the number of pixels of added spacing | 
The set_col_spacing() method sets the
spacing in pixels (specified by spacing) between the
specified column and the following column.
    def get_col_spacing(column)| 
 | a column in the table, 0 indicates the first column | 
| Returns : | the column spacing | 
The get_col_spacing() returns the
amount of space between the specified column, and the
following column. See the set_col_spacing() 
method.
    def set_row_spacings(spacing)| 
 | the number of pixels of space to place between every row in the table. | 
The set_row_spacings() method sets the
"row-spacing" property, that determines the space between every row in
table, to the value of spacing.
    def get_default_row_spacing()| Returns : | the default row spacing | 
The get_default_row_spacing() method
returns the value of the "row-spacing" property that specifies the default
row spacing for the table i.e. the spacing that will be used for newly added
rows. (See the set_row_spacings())
    def set_col_spacings(spacing)| 
 | the number of pixels of space to place between every column in the table. | 
The set_col_spacings() method sets the
"column-spacing" property, that determines the space between every column in
table, to the value of spacing.
    def get_default_col_spacing()| Returns : | the default column spacing | 
The get_default_col_spacing() method
returns the value of the "column-spacing" property to the default column
spacing for the table i.e. the spacing that will be used for newly added
columns. (See the set_col_spacings())
    def set_homogeneous(homogeneous)| 
 | if Trueall cells will be
the same size as the largest cell | 
The set_homogeneous() method sets the
"homogeneous" property to the value of homogeneous. If
homogeneous is True all cells will be the same size as the
largest cell.
    def get_homogeneous()| Returns : | Trueif the cells are all
set to the same size | 
The get_homogeneous() method returns the
value of the "homogeneous" property. If the value of "homogeneous" is
True all cells are set to the same width and height. (See
the set_homogeneous() 
method)