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. 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.