new

   $widget = Tickit::Widget::LinearBox->new( %args )

Returns a new "Tickit::Widget::LinearBox".

Takes the following named argmuents:

children => ARRAY[Tickit::Widget]

Optional. If provided, the widgets in this array will be added, with no additional options. This is now discouraged in favour of the "add" or "add_children" methods.

children

   @children = $widget->children

In scalar context, returns the number of contained children. In list context, returns a list of all the child widgets.

child_opts

   %opts = $widget->child_opts( $child_or_index )

Returns the options currently set for the given child, specified either by reference or by index.

set_child

   $widget->set_child( $index, $child )

Replaces the child widget at the given index with the given new one; preserving any options that are set on it.

set_child_opts

   $widget->set_child_opts( $child_or_index, %newopts )

Sets new options on the given child, specified either by reference or by index. Any options whose value is given as "undef" are deleted.

add

   $widget->add( $child, %opts )

Adds the widget as a new child of this one, with the given options.

This method returns the container widget instance itself making it suitable to use as a chaining mutator; e.g.

   my $container = Tickit::Widget::LinearBox->new( ... )
      ->add( Tickit::Widget::Static->new( ... ) )
      ->add( Tickit::Widget::Static->new( ... ) );

This should be preferred over using the "children" constructor argument, which is now discouraged.

add_children

   $widget->add_children( @children )

Adds each of the given widgets as a new child of this one. Each element of the list should either be a widget object reference directly, or an unblessed hash reference containing additional options. (See "split_widget_opts" in Tickit::Widget).

This method returns the container widget instance itself making it suitable to use as a chaining mutator.

remove

   $widget->remove( $child_or_index )

Removes the given child widget if present, by reference or index