OnBeforeGroupDelete

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

bool
функция-обработчик(
	int group_id
);

Событие "OnBeforeGroupDelete" вызывается перед удалением группы пользователей. Как правило задачи обработчика данного события - разрешить или запретить удаление группы пользователей.

Параметры

Параметр	Описание
group_id	ID удаляемой группы пользователей.

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

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

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

• Событие "OnGroupDelete"
• CGroup::Delete
• События

Пример

<?
// файл /bitrix/php_interface/init.php
// регистрируем обработчик
AddEventHandler("main", "OnBeforeGroupDelete", Array("MyClass", "OnBeforeGroupDeleteHandler"));
class MyClass
{
	// создаем обработчик события "OnBeforeGroupDelete"
	public static function OnBeforeGroupDeleteHandler($group_id)
	{
		// проверим есть ли связанные с удаляемой группой пользователей записи
		$strSql = "SELECT * FROM my_table WHERE GROUP_ID=".intval($group_id);
		$rs = $DB->Query($strSql, false, "FILE: ".__FILE__."<br>LINE: ".__LINE__);

		// если связанные записи есть то
		if ($ar = $rs->Fetch()) 
		{
			// запретим удаление группы пользователей
			global $APPLICATION;
			$APPLICATION->throwException("В моей таблице есть связанные записи.");
			return false;
		}
	}
}
?>

Пример регистрации функции-обработчика:

<?
// регистрируем обработчик события "OnBeforeGroupDelete" для модуля my_module_id
RegisterModuleDependences("main", "OnBeforeGroupDelete", 
	"my_module_id", "MyClass", "OnBeforeGroupDeleteHandler");
?>