OnBeforeGroupAdd

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

bool
EventHandler(
	array &arFields
);

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

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

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

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

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

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

• CGroup
• События

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

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