ПустоеЗначение

Проверить значение любого типа.

Синтаксис:

ПустоеЗначение(<3начение>)

Англоязычный синоним:

Empty Value

Параметры:

<3начение> Выражение любого типа данных, значение которого про­веряется на «пустое».

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

Функция возвращает числовое значение: 1 — значение пустое; 0 — значение не пустое.

Описание:

Функция ПустоеЗначение определяет, является ли пустым переданное в параметре значение. При этом применяется следующее правило:

• значение неопределенного типа — всегда пустое;

• значение типа «строка» проверяется как в методе ПустаяСтрока;

• значение типа «число» проверяется на равенство нулю;

• значение типа «дата» проверяется на пустое значение;

• значения следующих типов: «справочник», «перечисление», «документ», «счет», «вид субконто», «план счетов», «календарь» проверяются как в методах Выбран для соответствующего типа объекта.

Пример:

Если ПустоеЗначение(Код) = 1 Тогда

Предупреждение("Задайте непустое значение Кода !!!");

КонецЕсли;

ПолучитьПустоеЗначение

Получить пустое значение заданного типа данных.

Синтаксис:

ПолучитьПустоеЗначение(<Тип>)

Англоязычный синоним:

GetEmptyValue

Параметры:

<Тип>

Необязательный параметр. Строка или вид субконто или объект метаданных, задающий тип данных. Если параметр не задан, то функция возвращает пустое значение неопре­деленного типа.

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

Функция ПолучитьПустоеЗначение возвращает пустое значение заданно­го типа данных.

Описание:

Функция возвращает пустое значение заданного типа данных.

Пример:

Если ВыбФирма = ПолучитьПустоеЗначение("Справочник.Фирмы") = 1 Тогда

Предупреждение("Задайте непустое значение Фирмы");

КонецЕсли;

НазначитьВид

Для значений типа «Документ неопределенного вида», «Справочник неопределенного вида», «Счет неопределенного вида» назначает кон­кретный вид.

Синтаксис:

НазначитьВид(<3начение>, <Вид>)

Англоязычный синоним:

SetKind

Параметры:

<3начение>	Значение типа документ/справочник/счет неопределенного вида — обычно реквизит документа, справочника или диалога фор­мы.
<Вид>	Строка — вид значения может быть задан строкой, содержащей идентификатор кон­кретного справочника, документа, плана счетов. Вид субконто — вид значения может быть задан видом субконто, который имеет тип соответственно конкретного справочника, документа, счета.

Описание:

Процедура НазначитьВид используется для установки значениям типа «Документ неопределенного вида», «Справочник неопределенного вида», «Счет неопределенного вида» конкретный вид. При этом, если существующее значе­ние не соответсвует вновь установленному виду — то оно очищается.

Данная процедура используется обычно для значений реквизитов в диало­гах форм. В качестве первого параметра передается значение типа Справочник, Документ или Счет, в котором нужно установить вид. Во втором параметре указывается вид в качестве строки — идентификатора или вида субконто.

Данная процедура может использоваться в сочетании с методом элемента формы НеИзменятьВид. Это возволяет регулировать программно собственно вид, а само значение предоставить выбирать пользователю интерактивно.

Пример:

* Например, реквизиту документа «Контрагент» типа справочник неопреде­ленного вида, в зависимости от значений других реквизитов можно уста­новить вид «Организации» или «Сотрудники».

Процедура ВводНаОсновании(ДокОсн)

Если ДокОсн.Вид() = "Счет" Тогда

НазначитьВид(Контрагент, «Организации»);

Иначе

НазначитВид(Контрагент, «Сотрудники»);

КонецЕсли;

Форма.Контрагент.НеИзменятьВид(1);

КонецПроцедуры