Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

layout::manager::grid(3pm) [debian man page]

Layout::Manager::Grid(3pm)				User Contributed Perl Documentation				Layout::Manager::Grid(3pm)

NAME

       Layout::Manager::Grid - Simple grid-based layout manager.

DESCRIPTION

       Layout::Manager::Grid is a layout manager places components into evenly divided cells.

       When you instantiate a Grid manager, you must supply it with a count of how many rows and columns it will have.	For example, a Grid with 1
       column and 2 rows would look like:

	 +--------------------------------+
	 |				  |
	 |	     component 1	  |
	 |				  |
	 +--------------------------------+
	 |				  |
	 |	     component 2	  |
	 |				  |
	 +--------------------------------+

       The container is divided into as many <rows> * <columns> cells, with each taking up an equal amount of space.  A grid with 3 columns and 2
       rows would create 6 cells that consume 33% of the width and 50% of the height.

       Components are placed by specifying the cell they reside in via the row and column number.

	 $container->add_component($comp, { row => 0, column => 3 });

	 $container->add_component($comp, { row => 0, column => 2, height => 2 });

       Optionally, you may choose to override the default "width" or "height" of 1.  Setting it to a something else will cause the component to
       consume that many rows or columns worth of space.

       Grid is similar to Java's GridLayout <http://java.sun.com/docs/books/tutorial/uiswing/layout/grid.html>.

SYNOPSIS

	 $cont->add_component($comp1, { row => 0, column => 1 });
	 $cont->add_component($comp2, { row => 0, column => 2 });

	 my $lm = Layout::Manager::Grid->new(rows => 1, columns => 2);
	 $lm->do_layout($con);

   DYNAMIC SIZING
       If the container that the Grid is manging does not have one or both of it's dimensions set, Grid will compute the appropriate sizes.  The
       simple way for me to avoid writing a long explanation is to say it works similar to HTML tables.  Rows will become as big as their biggest
       consituent, as will columns.  It is common to add a Grid-managed component to a scene with only one of it's dimensions set.

ATTRIBUTES

   columns
       The number of columns in this Grid.

   rows
       The number of rows in this Grid.

METHODS

   do_layout
       Size and position the components in this layout.

AUTHOR

       Cory Watson, "<gphat@cpan.org>"

COPYRIGHT &; LICENSE
       Copyright 2008 - 2010 Cory G Watson

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.12.3							    2011-05-16						Layout::Manager::Grid(3pm)

Check Out this Related Man Page

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

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.14.2							    2010-05-29								Table(3pm)
Man Page