Специальные процедуры и функции
СтатусВозврата
Установить/определить статуса возврата предопределенной процедуры.
Синтаксис:
СтатусВозврата([<Статус>])
Англоязычный синоним:
ReturnStatus
Параметры:
| <Статус> | Необязательный параметр. Числовое выражение. Если задано значение 1, то устанавливается статус возврата – Выполнить Действие. Если задано значение 0, то устанавливается статус возврата – Отменить Действие. Если параметр опущен, то статус возврата предопределенной процедуры не меняется. |
Возвращаемое значение:
Число 1 – если статус возврата – Выполнить Действие;
Число 0 – если статус возврата – Отменить Действие.
Описание:
Применять функцию СтатусВозврата имеет смысл только в теле предопределенных процедур. При помощи функции СтатусВозврата можно установить или прочитать текущее значение статуса возврата конкретной предопределенной процедуры, где была вызвана данная функция.
Значение статуса возврата предопределенной процедуры используется системой при завершении отработки любой предопределенной процедуры, чтобы определить, выполнять ли системно событие, которое вызвало данную предопределенную процедуру.
Замечание
Начальное значение статуса возврата предопределенной процедуры равно 1 (Выполнить Действие), которое устанавливается системой при вызове предопределенной процедуры.
В тексте программного модуля возможно использование данного оператора как процедуры или как функции. При использовании в качестве функции, возвращаемое значение соответствует текущему статусу возврата предопределенной процедуры, которое было до вызова данной функции. В данном случае параметр <Статус> можно опускать.
Если параметр <Статус> задан явно, то после выполнения данной функции статус возврата установится в заданное значение.
Пример:
Если в предопределенной процедуре ПриЗаписи установить статус возврата – 0 (например, если неверно заполнены реквизиты), то документ не будет записываться.
Процедура ПриЗаписи()
Если Клиент.Выбран() = 0 Тогда
Предупреждение("Запись отменена! Не задан клиент!");
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
Если в предопределенной процедуре ВводНаОсновании установить статус возврата – 0, то ввод нового документа будет отменен и форма нового документа не откроется.
Процедура ВводНаОсновании(ДокОснование)
Автор = Пользователь;
ДокВид = ДокОснование.Вид();
Если (ДокВид = "Счет") ИЛИ (ДокВид = "Счет_фактура")
ИЛИ (ДокВид = "РасходнаяКредит") ИЛИ (ДокВид = РасходнаяРеализ") Тогда
Автор = Пользователь;
ДокВид = ДокОснование.Вид();
Фирма = ДокОснование.Фирма;
Клиент = ДокОснование.Клиент;
Основание = ДокВид + " № " + ДокОснование.НомерДок;
Сумма = ДокОснование.Итог("Сумма");
НДС = ДокОснование.Итог("НДС");
Иначе
Предупреждение("Недопустимый вид документа основания!");
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: "Системные предопределенные процедуры"