Toc Gallery Index Tree Gtk.Table

Hierarchy

Description

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.

Types

Subprograms

  • procedure Gtk_New (Widget : out Gtk_Table; Rows : Guint; Columns : Guint; Homogeneous : 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.
  • procedure Initialize (Widget : access Gtk_Table_Record'Class; Rows : Guint; Columns : Guint; Homogeneous : Boolean);
    Internal initialization function. See the section "Creating your own widgets" in the documentation.
  • function Get_Type return Gtk.Gtk_Type;
    Return the internal value associated with a Gtk_Table.
  • procedure Resize (Table : access Gtk_Table_Record; Rows : Guint; Columns : 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 : Guint; Right_Attach : Guint; Top_Attach : Guint; Bottom_Attach : Guint; Xoptions : Gtk_Attach_Options := Expand or Fill; Yoptions : Gtk_Attach_Options := Expand or Fill; Xpadding : Guint := 0; Ypadding : 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 : Guint; Right_Attach : Guint; Top_Attach : Guint; Bottom_Attach : 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 : Guint; Spacing : Guint);
    Set the spacing insert between Row and the next one. Spacing is in pixels.
  • procedure Set_Col_Spacing (Table : access Gtk_Table_Record; Column : Guint; Spacing : Guint);
    Set the spacing in pixels between Column and the next one.
  • procedure Set_Row_Spacings (Table : access Gtk_Table_Record; Spacing : Guint);
    Set the spacing for all the rows.
  • procedure Set_Col_Spacings (Table : access Gtk_Table_Record; Spacing : Guint);
    Set the spacing for all the columns.
  • procedure Set_Homogeneous (Table : access Gtk_Table_Record; Homogeneous : 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.
  • function Get_Row_Spacing (Table : access Gtk_Table_Record; Row : Guint) return Guint;
    Return the spacing in pixels between Row and the next one.
  • function Get_Col_Spacing (Table : access Gtk_Table_Record; Column : Guint) return Guint;
    Return the spacing in pixels between Column and the next one.
  • function Get_Default_Row_Spacing (Table : access Gtk_Table_Record) return Guint;
    Return the default spacing for the rows.
  • function Get_Default_Col_Spacing (Table : access Gtk_Table_Record) return Guint;
    Return the default spacing for the columns.
  • function Get_Homogeneous (Table : access Gtk_Table_Record) return Boolean;
    Return the homogeneous status of the table. See Set_Homogeneous for more details.

Signals

Properties

  • Column_Spacing_Property
    Guint
    The amount of space between two consecutive columns
    See: Set_Row_Spacing
  • Homogeneous_Property
    Boolean
    If TRUE this means the table cells are all the same
  • N_Columns_Property
    Guint
    The number of columns in the table
    See: Resize
  • N_Rows_Property
    Guint
    The number of rows in the table
    See: Resize
  • Row_Spacing_Property
    Guint
    The amount of space between two consecutive rows
    See: Set_Row_Spacing

Child Properties

  • Bottom_Attach_Property
    Uint
    The row number to attach the bottom of the child to
  • Left_Attach_Property
    Uint
    The column number to attach the left side of the child to
  • Right_Attach_Property
    Uint
    The column number to attach the right side of a child widget to
  • Top_Attach_Property
    Uint
    The row number to attach the top of a child widget to
  • X_Options_Property
    Flags
    Options specifying the horizontal behaviour of the child
  • X_Padding_Property
    Uint
    Extra space to put between the child and its left and right
  • Y_Options_Property
    Flags
    Options specifying the vertical behaviour of the child
  • Y_Padding_Property
    Uint
    Extra space to put between the child and its upper and lower

Alphabetical Index