bool
EventHandler(
 int ID,
 array &arFields
);

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

Примечание: событие добавлено в ядре 9.5.8.

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

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

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

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

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

См. также

• CGroup
• Обработка событий

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

<?
AddEventHandler("main", "OnBeforeGroupUpdate", "MyOnBeforeGroupUpdate");
function MyOnBeforeGroupUpdate($ID, &$arFields)
{
	if($ID == 1)
		$arFields["DESCRIPTION"] = "Главная группа админов.";
}
?>

Пользовательские комментарии

Пользовательские комментарии не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Добавлять комментарии могут только зарегистрированные пользователи. Сообщения для просмотра появляются после модерации.