SelectBoxM

Описание и параметры

string
SelectBoxM(
	string name,
	CDBResult values,
	array selected,
	string top_element = "",
	bool select_top_element = false,
	int size = 5,
	string add_to_tag = "class=\"typeselect\""
);

Возвращает HTML код тега <select multiple> (выпадающий список с множественными вариантами выбора ответа) на основании данных из объекта класса CDBResult.

Параметры функции

Параметр	Описание
name	Имя тэга: <select name="name" ... >
values	Элементы списка. Объект типа CDBResult, содержащий набор записей, каждая из которых должна иметь по два: "REFERENCE_ID" (значение элемента списка) и "REFERENCE" (заголовок элемента списка).
selected	Выбранные элементы. Массив, элементы которого будут сравниваться с полями "REFERENCE_ID" набора записей передаваемого в параметре values, в случае совпадения элемент будет "выбран" (selected).
top_element	Заголовок специального элемента который всегда помещается первым в списке и он может быть всегда выбран (контролируется параметром select_top_element). Значение этого элемента - "NOT_REF". Необязательный параметр. По умолчанию - "" (не добавлять подобный элемент).
select_top_element	Если значение "true", то элемент top_element будет всегда выбран (selected). Необязательный параметр. По умолчанию - "false" (не выбирать).
size	Поле size тэга select: <select size="size" ... > В данном параметре передается количество видимых строк в списке множественного выбора. Параметр необязательный. Значение по умолчанию - 5.
add_to_tag	Произвольный HTML который будет добавлен в тэг: <select add_to_tag ... > Необязательный параметр. По умолчанию - "class=\"typeselect\"".

Смотрите также

SelectBoxMFromArray

Пример использования

<?
// сформируем выборку из таблицы групп
$strSql = "
	SELECT
		G.ID as REFERENCE_ID,
		G.NAME as REFERENCE
	FROM
		b_group G
	WHERE
		G.ID<>2 -- группа everybody которой все принадлежат по умолчанию
";
$rs = $DB->Query($strSql, false, "FILE: ".__FILE__."<br>LINE: ".__LINE__);

// выведем список групп с множественным выбором
echo SelectBoxM("arrGROUP[]", $rs, $arrGROUP, "< группа everybody >", true, 20, 
"class =\"inputselect\"");
?>