Form::Control::select(3pm)

NAME

Embperl::Form::Control::select - A select control inside an Embperl
Form

{
type    => 'select',
text    => 'blabla',
name    => 'foo',
values  => [1,2,3],
options => ['foo', 'bar', 'none'],
rows    => 5
}

Used to create an select control inside an Embperl Form. See
Embperl::Form on how to specify parameters.
PARAMETER: type; Needs to be 'select'; name; Specifies the name of the select control; text; Will be used as label for the select control; values; Gives the values as an array ref of the select control.; options; Gives the options as an array ref that should be displayed to the user. If no options are given, the values from values are used.; rows; If specified a select box is display with the given number of lines.
If not specified or undef, a drop down list is shown.; addtop; Array ref which contains items that should be added at the top of the
select box. Each item consists of an array ref with two entries, the
first is the value and the second is the option that is displayed on
the page. If the second is missing the value (first entry)is displayed. Example:

addtop => [ [1 => 'first item'], [2 => 'second item']]; addbottom; Array ref which contains items that should be added at the bottom of
the select box. Each item consists of an array ref with two entries,
the first is the value and the second is the option that is displayed
on the page. If the second is missing the value (first entry)is
displayed. Example:

addbottom => [ [9999 => 'last item'], [9999 => 'very last item']]; filter; If given, only items where the value matches the regex given in
"filter" are displayed.

G. Richter (richter@dev.ecos.de)