The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

IWL::Combo - a combo box widget

INHERITANCE

IWL::Object -> IWL::Widget -> IWL::Input -> IWL::Combo

DESCRIPTION

The Combo widget provides a wrapper for the <select> markup tag.

CONSTRUCTOR

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

Where %ARGS is an optional hash parameter with with key-values corresponding to the attributes that a regular <select> markup would have.

METHODS

appendOption (TEXT, VALUE, [SELECTED])

Appends an option to the combobox.

Parameter: TEXT - the text to be appended, VALUE - the value that will be passed along, SELECTED - true if the option is selected

prependOption (TEXT, VALUE, [SELECTED])

Prepends an option to the combobox.

Parameter: TEXT - the text to be prepended, VALUE - the value that will be passed along, SELECTED - true if the option is selected

setMultiple (BOOL)

Sets whether the combo box will have multiple selection

Parameters: BOOL - true if the combo box should be multiple-selection enabled

isMultiple

Returns true if the combo is set to support multiple selection

extractState (STATE)

Update the IWL::Stash(3pm) STATE according to the combo state, ie. reflect the selected and unselected entries.

Note that this method does not work absolutely correct if you have multiple HTML input elements with the same name (attribute). It will update STATE as if it was the only element in the entire form.

LICENCE AND COPYRIGHT

Copyright (c) 2006-2007 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.

1 POD Error

The following errors were encountered while parsing the POD:

Around line 180:

You forgot a '=back' before '=head1'