Package: gtk

Function gtk-table-attach

Lambda List

gtk-table-attach (table child left right top bottom &key x-options y-options  x-padding y-padding)

Arguments

table -- the gtk-table widget to add a new widget to
child -- the gtk-widget child widget to add
left -- an unsigned integer with the column number to attach the left side of a child widget to
right -- an unsigned integer with the column number to attach the right side of a child widget to
top -- an unsigned ineger with the row number to attach the top of a child widget to
bottom -- an unsigned integer with the row number to attach the bottom of a child widget to
x-options -- the gtk-attach-options flags used to specify the properties of the child widget when the table is resized
y-options -- the same as x-options, except this field determines behaviour of vertical resizing
x-padding -- an unsigned integer specifying the padding on the left and right of the child widget being added to the table
y-padding -- an unsigned integer with the amount of padding above and below the child widget

Details

Adds a child widget to a table. The number of cells that a child widget will occupy is specified by the arguments left, right, top and bottom. These each represent the leftmost, rightmost, uppermost and lowest column and row numbers of the table. Columns and rows are indexed from zero.

The keyword arguments x-options and y-options have the default value '(:expand :fill). The keyword arguments x-padding and y-padding have the default value 0.

Example

To make a button occupy the lower right cell of a 2 x 2 table, use
 (gtk-table-attach table button 1 2 1 2)    
If you want to make the button span the entire bottom row, use
 (gtk-table-attach table button 0 2 1 2)    

Lisp implementation

The C library has the function gtk_table_attach_default (). This function is included in the Lisp library via keyword arguments with default values for the function gtk-table-attach.

Warning

The function gtk-table-attach has been deprecated since version 3.4 and should not be used in newly written code. Use the gtk-grid widget with the function gtk-grid-attach. Note that the attach arguments differ between those two functions.
 

See also

*2021-7-20