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
gtk:table-new function, the size of which can later be changed with the
gtk:table-resize function. Widgets can be added to a table using the
gtk:table-attach function.
To alter the space next to a specific row, use the
gtk:table-set-row-spacing function, and for a column the
gtk:table-set-col-spacing function. The gaps between all rows or columns can be changed by calling the
gtk:table-row-spacing or
gtk:table-column-spacing functions respectively. Note that spacing is added between the children, while padding added by the
gtk:table-attach
function is added on either side of the widget it belongs to.
The
gtk:table-homogeneous function 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