NAME

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

SYNOPSIS

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

DESCRIPTION

       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.

       multiple

       If set to true, allows multiple selections.

Author

       G. Richter (richter at embperl dot org)

See Also

       perl(1), Embperl, Embperl::Form