Scroll to navigation

Tickit::Widget::VSplit(3pm) User Contributed Perl Documentation Tickit::Widget::VSplit(3pm)

NAME

"Tickit::Widget::VSplit" - an adjustable vertical split between two widgets

SYNOPSIS

   use Tickit;
   use Tickit::Widget::VSplit;
   use Tickit::Widget::Static;
   my $vsplit = Tickit::Widget::VSplit->new
      ->set_left_child ( Tickit::Widget::Static->new( text => "Text above" ) ),
      ->set_right_child( Tickit::Widget::Static->new( text => "Text below" ) );
   Tickit->new( root => $vsplit )->run;

DESCRIPTION

This container widget holds two child widgets, displayed side by side. The two widgets are displayed with a vertical split bar between them, which reacts to mouse click-drag events, allowing the user to adjust the proportion of space given to the two widgets.

STYLE

The default style pen is used as the widget pen. The following style pen prefixes are also used:

The pen used to render the vertical split area

The following style keys are used:

The number of columns of spacing between the left and right child widgets

The following style tags are used:

:active
Set when a mouse drag resize operation is occurring

CONSTRUCTOR

new

   $vsplit = Tickit::Widget::VSplit->new( %args )

Constructs a new "Tickit::Widget::VSplit" object.

Takes the following named arguments

left_child => WIDGET
right_child => WIDGET
Child widgets to use.

These options are now discouraged in favour of the "set_left_child" and "set_right_child" methods.

ACCESSORS

left_child

set_left_child

   $child = $hsplit->left_child
   $vsplit->set_left_child( $child )

Accessor for the child widget used in the left half of the display.

right_child

set_right_child

   $child = $hsplit->right_child
   $vsplit->set_right_child( $child )

Accessor for the child widget used in the right half of the display.

These mutators returning the container widget itself making them suitable to use as chaining mutators; e.g.

   my $container = Tickit::Widget::VSplit->new( ... )
      ->set_left_child ( Tickit::Widget::Box->new ... )
      ->set_right_child( Tickit::Widget::Box->new ... );

These should be preferred over using the "left_child" and "right_child" constructor arguments, which are now discouraged.

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>

2020-11-04 perl v5.30.3