Reference: scrolling_list
Author: Ellen Siever, Stephen Spainhour & Nathan Patwardhan
Date: 1999-07-02T01:55:57Z

#

| Chapter 10 The CGI.pm Module |

## scrolling_list

     print
    $query->scrolling_list('name',\@list[,selected,size,'true',\%labelhash]);

Generates a scrolling list.

name

  The name to assign the input to (required).

\@list

  An array reference with the list items. You can also use an anonymous array reference.

selected

  The menu item(s) to be initially selected (default is that nothing is selected). This can be a single value or a reference to a list of values.

size

  The number of elements to display in the list box.

'true'

  Allow multiple selections.

\%labelhash

  A hash reference listing labels for each list item. Default is the list text itself. See `popup_menu` for an example.

  Using named parameters, the syntax is:

  >     print $query->scrolling_list(-name=>'name',
  >                                  -values=>\@listarray,
  >                                  -default=>selected,
  >                                  -size=>size,
  >                                  -multiple=>'true',
  >                                  -labels=>\%labelhash,
  >                                  -onChange=>function,
  >                                  -onFocus=>function,
  >                                  -onBlur=>function);

  `-onChange=>``function`

    Browser should execute `function` when the user changes the text field.

  `-onFocus=>``function`

    Browser should execute `function` when the focus is on on the text field.

  `-onBlur=>``function`

    Browser should execute `function` when the focus leaves the text field.

Reference: script_name |  | Reference: self_url