NAME

IWL::Label - a label widget

INHERITANCE

IWL::Error -> IWL::Object -> IWL::Widget -> IWL::Label

DESCRIPTION

The Label widget is a basic container widget specifically targeted for holding one text object.

CONSTRUCTOR

IWL::Label->new ([%ARGS])

Where %ARGS is an optional hash parameter with with key-values:

expand

True if the label should expand to fill all the given area false if the label should be as long as the text inside it. (expand => false doesn't work with multi-line labels)

METHODS

appendText (TEXT)

Appends the given text string to the label widget.

Parameters: TEXT - the text string

appendTextType (TEXT, TYPE, [ATTRS])

Appends the given text string to the label widget, with type and style settings.

Parameters: TEXT - the text string, TYPE - the text type [em, strong, code, etc.], ATTRS - an attributes hash.

Returns false if incorrect type was given.

setText (TEXT)

Sets the given text string to the label widget, replacing the already existing text

Parameters: TEXT - the text string

getText

Rethrs the text of the label

setJustify (JUSTIFICATION)

Sets the justification of the label.

Parameters: JUSTIFICATION - the justification type: left, right, center or justify

Returns false if incorrect justification was specified.

LICENCE AND COPYRIGHT

Copyright (c) 2006-2008 Viktor Kojouharov. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perldoc perlartistic.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.