OnBeforeGroupAdd

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

bool
EventHandler(
	array &arFields
);

Событие вызывается в методе CGroup::Add до добавления группы, и может быть использовано для отмены добавления или переопределения некоторых полей.

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

Параметр	Описание
arFields	Список полей (класс CGroup) добавляемой группы пользователей.

Параметр arFields данного обработчика является ссылкой на исходные переменные. Поэтому если изменить значение параметра внутри обработчика, это приведет к смене значения исходной переменной, поступившей на вход функции-обработчика.

Возвращаемое значение

Для отмены добавления группы и прекращении выполнения метода CGroup::Add необходимо в функции-обработчике создать исключение методом $APPLICATION->ThrowException() и вернуть false.

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

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

<?
AddEventHandler("main", "OnBeforeGroupAdd", "MyOnBeforeGroupAdd");
public static function MyOnBeforeGroupAdd(&$arFields)
{
	if($arFields["DESCRIPTION"] == '')
		$arFields["DESCRIPTION"] = "Описание группы";
}
?>