[Contents] [Back] [Prev] [Up] [Next] [Forward]

# Package Gtk.Table

A Gtk_Table is a container that can contain any number of children. Each of them is attached to a specific row and a specific column in widget. Every row in the table must have the same height, and every column must have the same width if the table was said as Homogeneous. But you can also decide to have an heterogeneous table, where the width and height are set by the children contained in the table. Check out the Gtk_Sheet widget for a different kind of table that can also contain text and images in a more efficient way.

- Gtk.Table Widget Hierarchy
- Gtk.Table Subprograms

## Widget Hierarchy

    Gtk_Object                    (see section Package Gtk.Object)
       \___ Gtk_Widget            (see section Package Gtk.Widget)
          \___ Gtk_Container      (see section Package Gtk.Container)
             \___ Gtk_Table       (see section Package Gtk.Table)

## Subprograms

    procedure Gtk_New
      (Widget             : out    Gtk_Table;
       Rows               : in     Guint;
       Columns            : in     Guint;
       Homogeneous        : in     Boolean);

| Create a new table. The width allocated to the table is divided into Columns columns, which all have the same width if Homogeneous is True. If Homogeneous is False, the width will be calculated with the children contained in the table. Same behavior for the rows.

    function Get_Type              return Gtk.Gtk_Type;

| Return the internal value associated with a Gtk_Table.

    procedure Resize
      (Table              : access Gtk_Table_Record;
       Rows               : in     Guint;
       Columns            : in     Guint);

| Modify the number of rows and columns in the table.

    procedure Attach
      (Table              : access Gtk_Table_Record;
       Child              : access Gtk.Widget.Gtk_Widget_Record'Class;
       Left_Attach        : in     Guint;
       Right_Attach       : in     Guint;
       Top_Attach         : in     Guint;
       Bottom_Attach      : in     Guint;
       Xoptions           : in     Gtk_Attach_Options
                           := Expand or Fill;
       Yoptions           : in     Gtk_Attach_Options
                           := Expand or Fill;
       Xpadding           : in     Guint := 0;
       Ypadding           : in     Guint := 0);

Insert a new widget in the table.
All the attachments are relative to the separations between columns and rows (for instance, to insert a widget spanning the first two columns in the table, you should put Left_Attach=0 and Right_Attach=2). Same behavior for the rows. Xoptions and Yoptions indicate the behavior of the child when the table is resized (whether the child can shrink or expand). See the description in Gtk.Box for more information on the possible values. Xpadding and Ypadding are the amount of space left around the child.

    procedure Attach_Defaults
      (Table              : access Gtk_Table_Record;
       Widget             : access Gtk.Widget.Gtk_Widget_Record'Class;
       Left_Attach        : in     Guint;
       Right_Attach       : in     Guint;
       Top_Attach         : in     Guint;
       Bottom_Attach      : in     Guint);

| Insert a new widget in the table, with default values. No padding is put around the child, and the options are set to Expand and Fill. This call is similar to Attach with default values and is only provided for compatibility.

    procedure Set_Row_Spacing
      (Table              : access Gtk_Table_Record;
       Row                : in     Guint;
       Spacing            : in     Guint);

| Set the spacing insert between Row and the next one. Spacing is in pixels.

    procedure Set_Row_Spacings
      (Table              : access Gtk_Table_Record;
       Spacing            : in     Guint);

| Set the spacing for all the rows.

    procedure Set_Col_Spacing
      (Table              : access Gtk_Table_Record;
       Column             : in     Guint;
       Spacing            : in     Guint);

| Set the spacing in pixels between Column and the next one.

    procedure Set_Col_Spacings
      (Table              : access Gtk_Table_Record;
       Spacing            : in     Guint);

| Set the spacing for all the columns.

    procedure Set_Homogeneous
      (Table              : access Gtk_Table_Record;
       Homogeneous        : in     Boolean);

| Indicate the homogeneous status of the table. If Homogeneous is True, the rows and columns of the table will all be allocated the same width or height.

[Contents] [Back] [Prev] [Up] [Next] [Forward]