start page | rating of books | rating of authors | reviews | copyrights

Perl in a Nutshell

Perl in a NutshellSearch this book
Previous: Reference: script_name Chapter 10
The CGI.pm Module
Next: Reference: self_url
 

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.


Previous: Reference: script_name Perl in a Nutshell Next: Reference: self_url
Reference: script_name Book Index Reference: self_url

Library Navigation Links

Copyright © 2001 O'Reilly & Associates. All rights reserved.