DOKK / manpages / debian 11 / libtickit-widgets-perl / Tickit::Widget::HSplit.3pm.en
Tickit::Widget::HSplit(3pm) User Contributed Perl Documentation Tickit::Widget::HSplit(3pm)

"Tickit::Widget::HSplit" - an adjustable horizontal split between two widgets

   use Tickit;
   use Tickit::Widget::HSplit;
   use Tickit::Widget::Static;
   my $hsplit = Tickit::Widget::HSplit->new
      ->set_top_child   ( Tickit::Widget::Static->new( text => "Text above" ) )
      ->set_bottom_child( Tickit::Widget::Static->new( text => "Text below" ) );
   Tickit->new( root => $hsplit )->run;

This container widget holds two child widgets, displayed one above the other. The two widgets are displayed with a horizontal 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.

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

The pen used to render the horizontal split area

The following style keys are used:

The number of lines of spacing between the top and bottom child widgets

The following style tags are used:

:active
Set when a mouse drag resize operation is occurring

   $hsplit = Tickit::Widget::HSplit->new( %args )

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

Takes the following named arguments

top_child => WIDGET
bottom_child => WIDGET
Child widgets to use.

These options are now discouraged in favour of the "set_top_child" and "set_bottom_child" methods.

   $child = $hsplit->top_child
   $hsplit->set_top_child( $child )

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

   $child = $hsplit->bottom_child
   $hsplit->set_bottom_child( $child )

Accessor for the child widget used in the bottom 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::HSplit->new( ... )
      ->set_top_child   ( Tickit::Widget::Box->new ... )
      ->set_bottom_child( Tickit::Widget::Box->new ... );

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

Paul Evans <leonerd@leonerd.org.uk>

2020-11-04 perl v5.30.3