path: root/docs/reference/pygtk-gtktable.xml

<?xml version="1.0" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id="class-gtktable">
  <refnamediv>
    <refname>gtk.Table</refname>
    <refpurpose>layout widgets in a two-dimensional array</refpurpose>
  </refnamediv>

  <refsect1>
    <title>Synopsis</title>

    <classsynopsis language="python">
      <ooclass><classname>gtk.Table</classname></ooclass>
      <ooclass><classname><link
linkend="class-gtkcontainer">gtk.Container</link></classname></ooclass>
      <constructorsynopsis language="python">
	<methodname><link linkend="constructor-gtktable">gtk.Table</link></methodname>
	<methodparam><parameter
		       role="keyword">rows</parameter><initializer>1</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">columns</parameter><initializer>1</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">homogeneous</parameter><initializer>False</initializer></methodparam>
      </constructorsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktable--resize">resize</link></methodname>
	<methodparam><parameter
		       role="keyword">rows</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">columns</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktable--attach">attach</link></methodname>
	<methodparam><parameter
		       role="keyword">child</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">left_attach</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">right_attach</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">top_attach</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">bottom_attach</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">xoptions</parameter><initializer>gtk.EXPAND|gtk.FILL</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">yoptions</parameter><initializer>gtk.EXPAND|gtk.FILL</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">xpadding</parameter><initializer>0</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">ypadding</parameter><initializer>0</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktable--set-row-spacing">set_row_spacing</link></methodname>
	<methodparam><parameter role="keyword">row</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">spacing</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktable--get-row-spacing">get_row_spacing</link></methodname>
	<methodparam><parameter role="keyword">row</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktable--set-col-spacing">set_col_spacing</link></methodname>
	<methodparam><parameter
		       role="keyword">column</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">spacing</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktable--get-col-spacing">get_col_spacing</link></methodname>
	<methodparam><parameter
		       role="keyword">column</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktable--set-row-spacings">set_row_spacings</link></methodname>
	<methodparam><parameter
		       role="keyword">spacing</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktable--get-default-row-spacing">get_default_row_spacing</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktable--set-col-spacings">set_col_spacings</link></methodname>
	<methodparam><parameter
		       role="keyword">spacing</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktable--get-default-col-spacing">get_default_col_spacing</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktable--set-homogeneous">set_homogeneous</link></methodname>
	<methodparam><parameter
		       role="keyword">homogeneous</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktable--get-homogeneous">get_homogeneous</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
    </classsynopsis>

  </refsect1>

  <refsect1>
    <title>Ancestry</title>

<synopsis>+-- <link linkend="class-gobject">gobject.GObject</link>
  +-- <link linkend="class-gtkobject">gtk.Object</link>
    +-- <link linkend="class-gtkwidget">gtk.Widget</link>
      +-- <link linkend="class-gtkcontainer">gtk.Container</link>
        +-- <link linkend="class-gtktable">gtk.Table</link>
</synopsis>

  </refsect1>
  
  <refsect1>
		<title>Implemented Interfaces</title>
		<para>
			<link linkend="class-gtktable"><classname>gtk.Table</classname></link>
			implements 
			<link linkend="class-gtkbuildable"><classname>gtk.Buildable</classname></link>
		</para>
	</refsect1>

  <refsect1 id="properties-gtktable">
    <title>gtk.Table Properties</title>

    <para><link linkend="properties-gtkobject">gtk.Object Properties</link></para>
    <para><link linkend="properties-gtkwidget">gtk.Widget Properties</link></para>
    <para><link linkend="properties-gtkcontainer">gtk.Container Properties</link></para>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

	    <row valign="top">
	      <entry>"column-spacing"</entry>
	      <entry>Read-Write</entry>
	      <entry>The amount of space between two adjacent
columns</entry>
	    </row>

	    <row valign="top">
	      <entry>"homogeneous"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, the table cells are all the
same width or height</entry>
	    </row>

	    <row valign="top">
	      <entry>"n-columns"</entry>
	      <entry>Read-Write</entry>
	      <entry>The number of columns in the table</entry>
	    </row>

	    <row valign="top">
	      <entry>"n-rows"</entry>
	      <entry>Read-Write</entry>
	      <entry>The number of rows in the table</entry>
	    </row>

	    <row valign="top">
	      <entry>"row-spacing"</entry>
	      <entry>Read-Write</entry>
	      <entry>The amount of space between two adjacent rows</entry>
	    </row>

	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>

  </refsect1>

  <refsect1 id="style-properties-gtktable">
    <title>gtk.Table Style Properties</title>

    <para><link linkend="style-properties-gtkwidget">gtk.Widget Style Properties</link></para>

  </refsect1>

  <refsect1 id="child-properties-gtktable">
    <title>gtk.Table Child Properties</title>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

	    <row valign="top">
	      <entry>"bottom-attach"</entry>
	      <entry>Read-Write</entry>
	      <entry>The lowest row of the child</entry>
	    </row>

	    <row valign="top">
	      <entry>"left-attach"</entry>
	      <entry>Read-Write</entry>
	      <entry>The leftmost column of the child</entry>
	    </row>

	    <row valign="top">
	      <entry>"right-attach"</entry>
	      <entry>Read-Write</entry>
	      <entry>The rightmost column of the child</entry>
	    </row>

	    <row valign="top">
	      <entry>"top-attach"</entry>
	      <entry>Read-Write</entry>
	      <entry>The uppermost row of the child</entry>
	    </row>

	    <row valign="top">
	      <entry>"x-options"</entry>
	      <entry>Read-Write</entry>
	      <entry>the horizontal behavior of the child - a combination
of: <literal>gtk.EXPAND</literal>, <literal>gtk.SHRINK</literal> and
<literal>gtk.FILL</literal></entry>
	    </row>

	    <row valign="top">
	      <entry>"x-padding"</entry>
	      <entry>Read-Write</entry>
	      <entry>Extra space added between the child widget and its left
and right neighbors, in pixels</entry>
	    </row>

	    <row valign="top">
	      <entry>"y-options"</entry>
	      <entry>Read-Write</entry>
	      <entry>the vertical behavior of the child - a combination of:
<literal>gtk.EXPAND</literal>, <literal>gtk.SHRINK</literal> and
<literal>gtk.FILL</literal></entry>
	    </row>

	    <row valign="top">
	      <entry>"y-padding"</entry>
	      <entry>Read-Write</entry>
	      <entry>Extra space added between the child widget and its top
and bottom neighbors, in pixels</entry>
	    </row>

	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>

  <refsect1 id="signal-prototypes-gtktable">
    <title>gtk.Table Signal Prototypes</title>

    <para><link linkend="signal-prototypes-gobject">gobject.GObject Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkobject">gtk.Object Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkwidget">gtk.Widget Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkcontainer">gtk.Container Signal Prototypes</link></para>
  </refsect1>

  </refsect1>

  <refsect1>
    <title>Description</title>

    <para>The <link
linkend="class-gtktable"><classname>gtk.Table</classname></link> manages a
group of widgets that are arranged 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 <link
linkend="constructor-gtktable">gtk.Table</link>(). The size of a table can
be changed using the <link
linkend="method-gtktable--resize"><methodname>resize</methodname>()</link>
method.</para>

    <para>Widgets can be added to a table using the <link
linkend="method-gtktable--attach"><methodname>attach</methodname>()</link>
method. To alter the space of the row next to a specific row, use the <link
linkend="method-gtktable--set-row-spacing"><methodname>set_row_spacing</methodname>()</link> 
method, and for a column, the <link
linkend="method-gtktable--set-col-spacing"><methodname>set_col_spacing</methodname>()</link> 
method. The gaps between all rows or columns can be changed by calling the
<link
linkend="method-gtktable--set-row-spacings"><methodname>set_row_spacings</methodname>()</link> 
or <link
linkend="method-gtktable--set-col-spacings"><methodname>set_col_spacings</methodname>()</link> 
methods respectively. The <link
linkend="method-gtktable--set-homogeneous"><methodname>set_homogeneous</methodname>()</link> 
method changes the setting that determines whether all cells in the table
will resize themselves to the size of the largest widget in the
table.</para>

 </refsect1>

  <refsect1 id="constructor-gtktable">
    <title>Constructor</title>

    <programlisting><constructorsynopsis language="python">
	<methodname>gtk.Table</methodname>
	<methodparam><parameter
		       role="keyword">rows</parameter><initializer>1</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">columns</parameter><initializer>1</initializer></methodparam>
	<methodparam><parameter
		       role="keyword">homogeneous</parameter><initializer>False</initializer></methodparam>
      </constructorsynopsis></programlisting>
    <variablelist>
      <varlistentry>
	<term><parameter role="keyword">rows</parameter>&nbsp;:</term>
	<listitem><simpara>the number of rows</simpara></listitem>
      </varlistentry>
      <varlistentry>
	<term><parameter role="keyword">columns</parameter>&nbsp;:</term>
	<listitem><simpara>the number of columns</simpara></listitem>
      </varlistentry>
      <varlistentry>
	<term><parameter
role="keyword">homogeneous</parameter>&nbsp;:</term>
	<listitem><simpara>if <literal>True</literal> all table cells will
be the same size as the largest cell</simpara></listitem>
      </varlistentry>
      <varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	<listitem><simpara>a new <link
linkend="class-gtktable"><classname>gtk.Table</classname></link>
widget</simpara></listitem>
      </varlistentry>
    </variablelist>

    <para>Creates a new <link
linkend="class-gtktable"><classname>gtk.Table</classname></link> widget with
the number of rows and columns specified by the value of
<parameter>rows</parameter> and <parameter>columns</parameter> respectively.
The value of <parameter>rows</parameter> and <parameter>columns</parameter>
must be in the range 0 .. 65535. If <parameter>homogeneous</parameter> is
<literal>True</literal> the table cells will all be the same size as the
largest cell. If <parameter>rows</parameter> or
<parameter>columns</parameter> are not specified they default to 1.</para>

  </refsect1>

  <refsect1>
    <title>Methods</title>

    <refsect2 id="method-gtktable--resize">
      <title>gtk.Table.resize</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>resize</methodname>
	  <methodparam><parameter
			 role="keyword">rows</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">columns</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">rows</parameter>&nbsp;:</term>
	  <listitem><simpara>The new number of rows.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">columns</parameter>&nbsp;:</term>
	  <listitem><simpara>The new number of columns.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>resize</methodname>() method changes the size of
the table as specified by the parameters, <parameter>rows</parameter> and
<parameter>columns</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtktable--attach">
      <title>gtk.Table.attach</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>attach</methodname>
	  <methodparam><parameter
			 role="keyword">child</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">left_attach</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">right_attach</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">top_attach</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">bottom_attach</parameter></methodparam>
	  <methodparam><parameter role="keyword">xoptions</parameter>
	    <initializer><literal>gtk.EXPAND</literal>|<literal>gtk.FILL</literal></initializer></methodparam>
    <methodparam><parameter role="keyword">yoptions</parameter>
	  <initializer><literal>gtk.EXPAND</literal>|<literal>gtk.FILL</literal></initializer></methodparam>
    <methodparam><parameter role="keyword">xpadding</parameter>
	  <initializer>0</initializer></methodparam>
    <methodparam><parameter role="keyword">ypadding</parameter>
	  <initializer>0</initializer></methodparam>
</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">child</parameter>&nbsp;:</term>
	  <listitem><simpara>the widget to add.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">left_attach</parameter>&nbsp;:</term>
	  <listitem><simpara>the column number to attach the left side of a
child widget to.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">right_attach</parameter>&nbsp;:</term>
	  <listitem><simpara>the column number to attach the right side of a
child widget to.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">top_attach</parameter>&nbsp;:</term>
	  <listitem><simpara>the row number to attach the top side of a
child widget to.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">bottom_attach</parameter>&nbsp;:</term>
	  <listitem><simpara>the row number to attach the bottom side of a
child widget to.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">xoptions</parameter>&nbsp;:</term>
	  <listitem><simpara>used to specify the properties of the child
widget when the table is resized horizontally.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">yoptions</parameter>&nbsp;:</term>
	  <listitem><simpara>used to specify the properties of the child
widget when the table is resized vertically.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">xpadding</parameter>&nbsp;:</term>
	  <listitem><simpara>the amount of padding to add on the left and
right of the widget</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">ypadding</parameter>&nbsp;:</term>
	  <listitem><simpara>the amount of padding to add above and below
the widget</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>attach</methodname>() method adds the widget
specified by <parameter>child</parameter> to the table. The number of
'cells' that a widget will occupy is specified by:</para>

      <itemizedlist>
	<listitem>
	  <simpara><parameter>left_attach</parameter> - the column to the
left of the widget</simpara>
	</listitem>
	<listitem>
	  <simpara><parameter>right_attach</parameter> - the column to the
right of the widget</simpara>
	</listitem>
	<listitem>
	  <simpara><parameter>top_attach</parameter> - the row above the
widget and</simpara>
	</listitem>
	<listitem>
	  <simpara><parameter>bottom_attach</parameter> - the row below the
widget</simpara>
	</listitem>
      </itemizedlist>

      <para>The <parameter>xoptions</parameter> and
<parameter>yoptions</parameter> determine the expansion properties of the
widget in the horizontal and vertical directions respectively (the default
value is <literal>gtk.FILL</literal>|<literal>gtk.EXPAND</literal>). The
value of the options is a combination of:</para>

      <variablelist>
	<varlistentry>
	  <term><literal>gtk.EXPAND</literal></term>
	  <listitem>
	    <simpara>the table cell should expand to take up any extra space
that has been allocated to the table.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.SHRINK</literal></term>
	  <listitem>
	    <simpara>the widget should shrink when the table cell
shrinks.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.FILL</literal></term>
	  <listitem>
	    <simpara>the widget should fill the space allocated to
it in the table cell.</simpara>
	  </listitem>
	</varlistentry>
      </variablelist>

      <para>The <parameter>xpadding</parameter> and <parameter>ypadding</parameter> parameters determine the extra padding added around the widget. By default these are 0.</para>

    </refsect2>

    <refsect2 id="method-gtktable--set-row-spacing">
      <title>gtk.Table.set_row_spacing</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_row_spacing</methodname>
	  <methodparam><parameter
			 role="keyword">row</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">spacing</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">row</parameter>&nbsp;:</term>
	  <listitem><simpara>the row number whose spacing will be
changed.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">spacing</parameter>&nbsp;:</term>
	  <listitem><simpara>the number of pixels of added
spacing</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_row_spacing</methodname>() method sets the
spacing in pixels (specified by <parameter>spacing</parameter>) between the
specified <parameter>row</parameter> and the following row.</para>

    </refsect2>

    <refsect2 id="method-gtktable--get-row-spacing">
      <title>gtk.Table.get_row_spacing</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_row_spacing</methodname>
	  <methodparam><parameter
			 role="keyword">row</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">row</parameter>&nbsp;:</term>
	  <listitem><simpara>a row in the table, 0 indicates the first
row</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the row spacing</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_row_spacing</methodname>() method returns
the amount of space between the specified <parameter>row</parameter>, and
the following row. See the <link
linkend="method-gtktable--set-row-spacing"><methodname>set_row_spacing</methodname>()</link> 
method.</para>

    </refsect2>

    <refsect2 id="method-gtktable--set-col-spacing">
      <title>gtk.Table.set_col_spacing</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_col_spacing</methodname>
	  <methodparam><parameter
			 role="keyword">column</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">spacing</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">column</parameter>&nbsp;:</term>
	  <listitem><simpara>the column number whose spacing will be
changed.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">spacing</parameter>&nbsp;:</term>
	  <listitem><simpara>the number of pixels of added
spacing</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_col_spacing</methodname>() method sets the
spacing in pixels (specified by <parameter>spacing</parameter>) between the
specified <parameter>column</parameter> and the following column.</para>

    </refsect2>

    <refsect2 id="method-gtktable--get-col-spacing">
      <title>gtk.Table.get_col_spacing</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_col_spacing</methodname>
	  <methodparam><parameter
			 role="keyword">column</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">column</parameter>&nbsp;:</term>
	  <listitem><simpara>a column in the table, 0 indicates the first
column</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the column spacing</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_col_spacing</methodname>() returns the
amount of space between the specified <parameter>column</parameter>, and the
following column. See the <link
linkend="method-gtktable--set-col-spacing"><methodname>set_col_spacing</methodname>()</link> 
method.</para>

    </refsect2>

    <refsect2 id="method-gtktable--set-row-spacings">
      <title>gtk.Table.set_row_spacings</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_row_spacings</methodname>
	  <methodparam><parameter
			 role="keyword">spacing</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">spacing</parameter>&nbsp;:</term>
	  <listitem><simpara>the number of pixels of space to place between
every row in the table.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_row_spacings</methodname>() method sets the
"row-spacing" property, that determines the space between every row in
table, to the value of <parameter>spacing</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtktable--get-default-row-spacing">
      <title>gtk.Table.get_default_row_spacing</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_default_row_spacing</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the default row spacing</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_default_row_spacing</methodname>() method
returns the value of the "row-spacing" property that specifies the default
row spacing for the table i.e. the spacing that will be used for newly added
rows. (See the <link
linkend="method-gtktable--set-row-spacings"><methodname>set_row_spacings</methodname>()</link>)</para>

    </refsect2>

    <refsect2 id="method-gtktable--set-col-spacings">
      <title>gtk.Table.set_col_spacings</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_col_spacings</methodname>
	  <methodparam><parameter
			 role="keyword">spacing</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">spacing</parameter>&nbsp;:</term>
	  <listitem><simpara>the number of pixels of space to place between
every column in the table.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_col_spacings</methodname>() method sets the
"column-spacing" property, that determines the space between every column in
table, to the value of <parameter>spacing</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtktable--get-default-col-spacing">
      <title>gtk.Table.get_default_col_spacing</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_default_col_spacing</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the default column spacing</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_default_col_spacing</methodname>() method
returns the value of the "column-spacing" property to the default column
spacing for the table i.e. the spacing that will be used for newly added
columns. (See the <link
linkend="method-gtktable--set-col-spacings"><methodname>set_col_spacings</methodname>()</link>)</para>

    </refsect2>

    <refsect2 id="method-gtktable--set-homogeneous">
      <title>gtk.Table.set_homogeneous</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_homogeneous</methodname>
	  <methodparam><parameter
			 role="keyword">homogeneous</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">homogeneous</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> all cells will be
the same size as the largest cell</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_homogeneous</methodname>() method sets the
"homogeneous" property to the value of <parameter>homogeneous</parameter>. If
homogeneous is <literal>True</literal> all cells will be the same size as the
largest cell.</para>

    </refsect2>

    <refsect2 id="method-gtktable--get-homogeneous">
      <title>gtk.Table.get_homogeneous</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_homogeneous</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the cells are all
set to the same size</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_homogeneous</methodname>() method returns the
value of the "homogeneous" property. If the value of "homogeneous" is
<literal>True</literal> all cells are set to the same width and height. (See
the <link
linkend="method-gtktable--set-homogeneous"><methodname>set_homogeneous</methodname>()</link> 
method)</para>

    </refsect2>

  </refsect1>

</refentry>