Package: gtk

Class gtk-table

Superclasses

gtk-container, gtk-widget, gtk-buildable, g-object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

None

Direct Slots

column-spacing
The column-spacing property of type :uint (Read / Write)
The amount of space between two consecutive columns.
Allowed values: <= 65535
Default value: 0
homogeneous
The homogeneous property of type :boolean (Read / Write)
If true, the table cells are all the same width/height.
Default value: false
n-columns
The n-columns property of type :uint (Read / Write)
The number of columns in the table.
Allowed values: [1,65535]
Default value: 1
n-rows
The n-rows property of type :uint (Read / Write)
The number of rows in the table.
Allowed values: [1,65535]
Default value: 1
row-spacing
The row-spacing property of type :uint (Read / Write)
The amount of space between two consecutive rows.
Allowed values: <= 65535
Default value: 0

Details

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
 

Slot Access Functions

Inherited Slot Access Functions

See also

*2021-7-20