GetDropDown

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

CDBResult
CFormStatus::GetDropDown(
	int form_id,
	array permission = array("MOVE"), 
	int owner_user_id = 0
)

Возвращает список статусов в виде объекта класса CDBResult в формате, пригодном для вывода выпадающего списка одиночного выбора.

Результирующий список будет состоять из статусов указанной веб-формы form_id. Статус будет включен в результирующий список только в том случае, если текущий пользователь обладает хотя бы одним из прав, указанных в параметре permission.

Метод нестатический.

Параметры метода

Параметр	Описание
form_id	ID веб-формы.
permission	Массив прав, одним из которых должен обладать текущий пользователь. В данном массиве возможны следующие значения: VIEW - право на просмотр; MOVE - право на перевод; EDIT - право на редактирование; DELETE - право на удаление. Параметр необязательный. По умолчанию - array("MOVE") (право на перевод результатов в соответствующий статус).
owner_user_id	Если данный метод используется для построения выпадающего списка доступных статусов конкретного результата, то в данном параметре необходимо указать ID пользователя, создавшего данный результат (владелец результата, поле результата - USER_ID). Параметр необязательный. По умолчанию - 0.

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

Права на результат

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

<?
$FORM_ID = 4; // ID веб-формы

// получим список всех доступных статусов
// для которых есть право просмотра у текущего пользователя
$rsStatuses = CFormStatus::GetDropdown($FORM_ID, array("VIEW"));

// выведем выпадающий список
echo SelectBox("STATUS_ID", $rsStatuses, "(выберете статус)", htmlspecialchars($STATUS_ID));
?>