OnBeforeEventMessageDelete

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

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

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

Параметры

Параметр	Описание
template_id	ID удаляемого почтового шаблона.

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

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

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

• Событие "OnEventMessageDelete"
• CEventMessage::Delete
• События

Примеры

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

<?
// файл /bitrix/modules/my_module_id/include.php
class MyClass
{
	// создаем обработчик события "OnBeforeEventMessageDelete"
	public static function OnBeforeEventMessageDeleteHandler($template_id)
	{
		// проверим есть ли связанные с удаляемым шаблоном записи
		$strSql = "SELECT * FROM my_table WHERE EMAIL_TEMPLATE_ID=".intval($template_id);
		$rs = $DB->Query($strSql, false, "FILE: ".__FILE__."<br>LINE: ".__LINE__);

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

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

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