Scroll to navigation

Tickit::Widget::Scroller::Item::Text(3pm) User Contributed Perl Documentation Tickit::Widget::Scroller::Item::Text(3pm)

NAME

"Tickit::Widget::Scroller::Item::Text" - add static text to a Scroller

SYNOPSIS

   use Tickit::Widget::Scroller;
   use Tickit::Widget::Scroller::Item::Text;
   my $scroller = Tickit::Widget::Scroller->new;
   $scroller->push(
      Tickit::Widget::Scroller::Item::Text->new( "Hello world" )
   );

DESCRIPTION

This implementation of Tickit::Widget::Scroller::Item displays a simple static piece of text. It will be wrapped on whitespace (characters matching the "/\s/" regexp pattern).

CONSTRUCTOR

new

   $item = Tickit::Widget::Scroller::Item::Text->new( $text, %opts );

Constructs a new text item, containing the given string of text. Once constructed, the item is immutable.

The following options are recognised in %opts:

If the text item needs to wrap, indent the second and subsequent lines by this amount. Does not apply to the first line.
Since version 0.30.

A number of columns to leave blank at the left and right edge of the item. This applies outside of any additional space added by "indent".

Since version 0.30.

Shortcut to setting both "margin_left" and "margin_right" to the same value.

A pen to set for rendering the item, including erasing its background. This will not be set while erasing area required for its margin.

METHODS

chunks

   @chunks = $item->chunks;

Returns the chunks of text displayed by this item. Each chunk is represented by an ARRAY reference of three fields, giving the text string, its width in columns, and various options

   [ $text, $width, %opts ]

Recognised options are:

Pen to render the chunk with.
If true, force a linebreak after this chunk; the next one starts on the following line.

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>

2023-10-04 perl v5.36.0