Tickit::ContainerWidget - abstract base class for widgets that contain other widgets
Tickit::ContainerWidget
TODO
This class acts as an abstract base class for widgets that contain at leaast one other widget object. It provides storage for a hash of "options" associated with each child widget.
Sets the child widget's parent, stores the options for the child, and calls the children_changed method. The concrete implementation will have to implement storage of this child widget.
children_changed
Removes the child widget's parent, and calls the children_changed method. The concrete implementation will have to remove this child from its storage.
Returns the options currently set for the given child as a key/value list in list context, or as a HASH reference in scalar context. The HASH reference in scalar context is the actual hash used to store the options - modifications to it will be preserved.
Sets new options on the given child. Any options whose value is given as undef are deleted.
undef
Required. Should return a list of all the contained child widgets. The order is not specified. This method is used by window_lost to remove the windows from all the child widgets automatically.
window_lost
Optional. An empty render method is provided for the case where the widget is purely a layout container that does not directly draw to its window. If the container requires drawing, this method may be overridden. Since the default implementation is empty, there is no need for a subclass to SUPER call it.
render
SUPER
Optional. If implemented, this method will be called after any change of the contained child widgets or their options. Typically this will be used to set windows on them by sub-dividing the window of the parent.
Optional. If implemented, this method will be called after a child widget changes or may have changed its size requirements. Typically this will be used to adjusts the windows allocated to children.
Paul Evans <leonerd@leonerd.org.uk>
To install Tickit, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Tickit
CPAN shell
perl -MCPAN -e shell install Tickit
For more information on module installation, please visit the detailed CPAN module installation guide.