NAME

Tickit::Widget::Border - draw a fixed-size border around a widget

SYNOPSIS

   use Tickit;
   use Tickit::Widget::Border;
   use Tickit::Widget::Static;

   my $border = Tickit::Widget::Border->new
      ->set_child(
         Tickit::Widget::Static->new(
            text   => "Hello, world",
            align  => "centre",
            valign => "middle",
         )
      );

   Tickit->new( root => $border )->run;

DESCRIPTION

This container widget holds a single child widget and implements a border by using Tickit::WidgetRole::Borderable.

STYLE

The default style pen is used as the widget pen.

CONSTRUCTOR

new

   $border = Tickit::Widget::Border->new( %args )

Constructs a new Tickit::Widget::Border object.

Takes arguments having the names of any of the set_* methods listed below, without the set_ prefix.

ACCESSSORS

top_border

set_top_border

   $lines = $border->top_border

   $border->set_top_border( $lines )

Return or set the number of lines of border at the top of the widget

bottom_border

set_bottom_border

   $lines = $border->bottom_border

   $border->set_bottom_border( $lines )

Return or set the number of lines of border at the bottom of the widget

left_border

set_left_border

   $cols = $border->left_border

   $border->set_left_border( $cols )

Return or set the number of cols of border at the left of the widget

right_border

set_right_border

   $cols = $border->right_border

   $border->set_right_border( $cols )

Return or set the number of cols of border at the right of the widget

set_h_border

   $border->set_h_border( $cols )

Set the number of cols of both horizontal (left and right) borders simultaneously

set_v_border

   $border->set_v_border( $cols )

Set the number of lines of both vertical (top and bottom) borders simultaneously

set_border

   $border->set_border( $count )

Set the number of cols or lines in all four borders simultaneously

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>