tk::table(3) [suse man page]

Table(3)						User Contributed Perl Documentation						  Table(3)

NAME

       Tk::Table - Scrollable 2 dimensional table of Tk widgets

SYNOPSIS

	 use Tk::Table;

	 $table = $parent->Table(-rows => number,
				 -columns => number,
				 -scrollbars => anchor,
				 -fixedrows => number,
				 -fixedcolumns => number,
				 -takefocus => boolean);

	 $widget = $table->Button(...);

	 $old = $table->put($row,$col,$widget);
	 $old = $table->put($row,$col,"Text");	# simple Label
	 $widget = $table->get($row,$col);

	 $cols = $table->totalColumns;
	 $rows = $table->totalRows;

	 $table->see($widget);
	 $table->see($row,$col);

	 ($row,$col) = $table->Posn($widget);

DESCRIPTION

       Tk::Table is an all-perl widget/geometry manager which allows a two dimensional table of arbitary perl/Tk widgets to be displayed.

       Entries in the Table are simply ordinary perl/Tk widgets. They should be created with the Table as their parent. Widgets are positioned in
       the table using:

	$table->put($row,$col,$widget)

       If $widget is not a reference it is treated as a string, and a Lable widget is created with the string as its text.

       All the widgets in each column are set to the same width - the requested width of the widest widget in the column.  Likewise, all the
       widgets in each row are set to the same height - the requested height of the tallest widget in the column.

       A number of rows and/or columns can be marked as 'fixed' - and so can serve as 'headings' for the remainder the rows which are scrollable.

       The requested size of the table as a whole is such that the number of rows specified by -rows (default 10), and number of columns specified
       by -columns (default 10) can be displayed.

       If the Table is told it can take the keyboard focus then cursor and scroll keys scroll the displayed widgets.

       The Table will create and manage its own scrollbars if requested via -scrollbars.

       The table can be emptied using

	$table->clear

       the widgets which were in the table are destroyed.

       The Tk::Table widget is derived from a Tk::Frame, so inherits all its configure options.

BUGS 
/ Snags / Possible enhancements
       o   Very large Tables consume a lot of X windows.

       o   No equivalent of pack's -anchor/-pad etc. options

SEE ALSO

       Tk::grid, Tk::HList, Tk::TableMatrix, Tk::MListbox, Tk::Columns

perl v5.12.1							    2007-11-08								  Table(3)

Gtk2::Table(3pm)					User Contributed Perl Documentation					  Gtk2::Table(3pm)

NAME

       Gtk2::Table - wrapper for GtkTable

HIERARCHY

	 Glib::Object
	 +----Glib::InitiallyUnowned
	      +----Gtk2::Object
		   +----Gtk2::Widget
			+----Gtk2::Container
			     +----Gtk2::Table

INTERFACES

	 Glib::Object::_Unregistered::AtkImplementorIface
	 Gtk2::Buildable

METHODS

   widget = Gtk2::Table->new ($rows, $columns, $homogeneous=FALSE)
       o   $rows (integer)

       o   $columns (integer)

       o   $homogeneous (boolean)

   $table->attach ($child, $left_attach, $right_attach, $top_attach, $bottom_attach, $xoptions, $yoptions, $xpadding, $ypadding)
       o   $child (Gtk2::Widget)

       o   $left_attach (integer)

       o   $right_attach (integer)

       o   $top_attach (integer)

       o   $bottom_attach (integer)

       o   $xoptions (Gtk2::AttachOptions)

       o   $yoptions (Gtk2::AttachOptions)

       o   $xpadding (integer)

       o   $ypadding (integer)

   $table->attach_defaults ($widget, $left_attach, $right_attach, $top_attach, $bottom_attach)
       o   $widget (Gtk2::Widget)

       o   $left_attach (integer)

       o   $right_attach (integer)

       o   $top_attach (integer)

       o   $bottom_attach (integer)

   integer = $table->get_col_spacing ($column)
       o   $column (integer)

   $table->set_col_spacing ($column, $spacing)
       o   $column (integer)

       o   $spacing (integer)

   $table->set_col_spacings ($spacing)
       o   $spacing (integer)

   integer = $table->get_default_col_spacing
   integer = $table->get_default_row_spacing
   boolean = $table->get_homogeneous
   $table->set_homogeneous ($homogeneous)
       o   $homogeneous (boolean)

   $table->resize ($rows, $columns)
       o   $rows (integer)

       o   $columns (integer)

   integer = $table->get_row_spacing ($row)
       o   $row (integer)

   $table->set_row_spacing ($row, $spacing)
       o   $row (integer)

       o   $spacing (integer)

   $table->set_row_spacings ($spacing)
       o   $spacing (integer)

   (rows, columns) = $table->get_size
       Since: gtk+ 2.22

PROPERTIES

       'column-spacing' (Glib::UInt : default 0 : readable / writable / private)
	   The amount of space between two consecutive columns

       'homogeneous' (boolean : default false : readable / writable / private)
	   If TRUE, the table cells are all the same width/height

       'n-columns' (Glib::UInt : default 1 : readable / writable / private)
	   The number of columns in the table

       'n-rows' (Glib::UInt : default 1 : readable / writable / private)
	   The number of rows in the table

       'row-spacing' (Glib::UInt : default 0 : readable / writable / private)
	   The amount of space between two consecutive rows

CHILD PROPERTIES

       'bottom-attach' (Glib::UInt : default 1 : readable / writable / private)
	   The row number to attach the bottom of the child to

       'left-attach' (Glib::UInt : default 0 : readable / writable / private)
	   The column number to attach the left side of the child to

       'right-attach' (Glib::UInt : default 1 : readable / writable / private)
	   The column number to attach the right side of a child widget to

       'top-attach' (Glib::UInt : default 0 : readable / writable / private)
	   The row number to attach the top of a child widget to

       'x-options' (Gtk2::AttachOptions : default expand,fill : readable / writable / private)
	   Options specifying the horizontal behaviour of the child

       'x-padding' (Glib::UInt : default 0 : readable / writable / private)
	   Extra space to put between the child and its left and right neighbors, in pixels

       'y-options' (Gtk2::AttachOptions : default expand,fill : readable / writable / private)
	   Options specifying the vertical behaviour of the child

       'y-padding' (Glib::UInt : default 0 : readable / writable / private)
	   Extra space to put between the child and its upper and lower neighbors, in pixels

ENUMS AND FLAGS

   flags Gtk2::AttachOptions
       o   'expand' / 'GTK_EXPAND'

       o   'shrink' / 'GTK_SHRINK'

       o   'fill' / 'GTK_FILL'

SEE ALSO

       Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container

COPYRIGHT

       Copyright (C) 2003-2011 by the gtk2-perl team.

       This software is licensed under the LGPL.  See Gtk2 for a full notice.

perl v5.14.2							    2012-05-27							  Gtk2::Table(3pm)