NAME

ProgressMonitor::Stringify::Field::Dynamic - a field implementation that renders a fixed value in a dynamic space, filling out remaining places.

SYNOPSIS

TBW

DESCRIPTION

This is a dynamic size field rendering a fixed value, but filling out to adapt to dynamically allocated space. Intended for use together with other fields in order to provide explanatory text or similar, while also being good overlaid messages and give as much space as possible.

Inherits from ProgressMonitor::Stringify::Fields::AbstractField.

METHODS

new( $hashRef )

Configuration data:

text (default => '')

The text to display.

filler (default => ' ')

The filler.

change_text( $newText)

Change the text to display and returns the old text.

The passed in text will be padded to the assigned width of the field if its shorter using the 'fillCharacter'. If it's too long, it will be cut.

AUTHOR

Kenneth Olwing, <knth at cpan.org>

BUGS

I wouldn't be surprised! If you can come up with a minimal test that shows the problem I might be able to take a look. Even better, send me a patch.

Please report any bugs or feature requests to bug-progressmonitor at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=ProgressMonitor. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find general documentation for this module with the perldoc command:

    perldoc ProgressMonitor

ACKNOWLEDGEMENTS

Thanks to my family. I'm deeply grateful for you!

COPYRIGHT & LICENSE

Copyright 2006,2007 Kenneth Olwing, all rights reserved.

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