scrolling_list

Team-Fly    

 
Webmaster in a Nutshell, 3rd Edition
By Robert Eckstein, Stephen Spainhour
Table of Contents
Chapter 14.  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 the text field.

-onBlur=> function

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


Team-Fly    
Top


Webmaster in a Nutshell
Webmaster in a Nutshell, Third Edition
ISBN: 0596003579
EAN: 2147483647
Year: 2002
Pages: 412

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net