WIKINDX METHODS

Method:
selectedBoxValueMultiple()

Class:
FORM

Method Call:
include_once("core/html/FORM.php");
STRING FORM::selectedBoxValueMultiple(STRING: $label, STRING: $name, ASSOC_ARRAY: $options, ARRAY: $selected, [INT: $size, INT: $override]);

Description:
Returns a form input element of type select (multiple) with $options being an associative array whose keys equal to the elements of $selected are pre-selected. $size is 3 by default. If $override is set, this overrides the select box character limit set by the user.

Unlike selectedBox(), this method sets the value parameter of the option tag to the key of the associative array $options.

Usage:
$label is printed a line above the select box. To not print $label, set it to FALSE.

If $options is: 

	array(
		"en"	=>	"English",
		"de"	=>	"Deutsch",
		"ts"	=>	"Tsetswana",
		);
and $selected is:
	array("en", "ts");
then 
	$pString = FORM::selectedBoxValueMultiple(FALSE, "language", $options, $selected);
would return the string: 
	<select name="language" size="3">
	<option  value="en" selected>English</option>
	<option value="de">Deutsch</option>
	<option value="ts" selected>Tsetswana</option>
	</select>

WIKINDX home      WIKINDX usage      WIKINDX classes