The
gtk-table widget allows the programmer to arrange widgets 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 the function
gtk-table-new, the size of which can later be changed with the function
gtk-table-resize. Widgets can be added to a table using the function
gtk-table-attach.
To alter the space next to a specific row, use the function
gtk-table-set-row-spacing, and for a column the function
gtk-table-set-col-spacing. The gaps between all rows or columns can be changed by calling the functions
gtk-table-row-spacing or
gtk-table-column-spacing respectively. Note that spacing is added
between the children, while padding added by the function
gtk-table-attach is added on either side of the widget it belongs to.
The function
gtk-table-homogeneous can be used to set whether all
cells in the table will resize themselves to the size of the largest widget
in the table.
Warning
The
gtk-table widget has been deprecated since GTK 3.4. Use the
gtk-grid widget instead. It provides the same capabilities as the
gtk-table widget for arranging widgets in a rectangular grid, but
does support height-for-width geometry management.
Child Property Details
- bottom-attach
- The bottom-attach child property of type :uint (Read / Write)
The row number to attach the bottom of the child widget to.
Allowed values: [1,65535]
Default value: 1 - left-attach
- The left-attach child property of type :uint (Read / Write)
The column number to attach the left side of the child widget to.
Allowed values: <= 65535
Default value: 0 - right-attach
- The right-attach child property of type :uint (Read / Write)
The column number to attach the right side of a child widget to.
Allowed values: [1,65535]
Default value: 1 - top-attach
- The top-attach child property of type :uint (Read / Write)
The row number to attach the top of a child widget to.
Allowed values: <= 65535
Default value: 0 - x-options
- The x-options child property of type gtk-attach-options (Read / Write)
Options specifying the horizontal behaviour of the child widget.
Default value: '(:expand :fill) - x-padding
- The x-padding child property of type :uint (Read / Write)
Extra space to put between the child widget and its left and right neighbors, in pixels.
Allowed values: <= 65535
Default value: 0 - y-options
- The y-options child property of type gtk-attach-options (Read / Write)
Options specifying the vertical behaviour of the child widget.
Default value: '(:expand :fill) - y-padding
- The y-padding child property of type :uint (Read / Write)
Extra space to put between the child widget and its upper and lower neighbors, in pixels.
Allowed values: <= 65535
Default value: 0