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

NAME

       Layout::Manager::Flow - Directional layout manager

DESCRIPTION

       Layout::Manager::Flow is a layout manager that anchors components in one of the four cardinal directions.

       When you instantiate a Flow manager, you may supply it with an anchor value which may be one of north, south, east or west.  The example
       below shows how the default anchor value of north works when you add two components.

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

       Components are placed in the order they are added.  If two items are added with a 'north' anchor then the first item will be rendered above
       the second.  Components will be expanded to take up all space perpendicular to their anchor.  North and south will expand widths while east
       and west will expand heights.

       Flow is similar to Java's FlowLayout <http://java.sun.com/docs/books/tutorial/uiswing/layout/flow.html>.  It does not, however, center
       components.  This features may be added in the future if they are needed.

SYNOPSIS

	 $cont->add_component($comp1);
	 $cont->add_component($comp2);

	 my $lm = Layout::Manager::Flow->new(anchor => 'north');
	 $lm->do_layout($cont);

ATTRIBUTES

   anchor
       The direction this manager is anchored.	Valid values are north, south, east and west.

   used
       Returns the amount of space used an arrayref in the form of "[ $width, $height ]".

   wrap
       If set to a true value, then component will be 'wrapped' when they do not fit.  This currently only works for East and West anchored
       layouts.

METHODS

   do_layout
       Size and position the components in this layout.

AUTHOR

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

COPYRIGHT &; LICENSE
       Copyright 2008 by 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::Flow(3pm)