0

Функция ВвестиПеречисление

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

Синтаксис

Функция ВвестиПеречисление() имеет следующий синтаксис:

число ВвестиПеречисление(Переменная, Подсказка [, Таймаут])

А также альтернативный англоязычный синтаксис:

number InputEnum(Variable, Title [, Timeout])

Описание параметров

Описание параметров функции ВвестиПеречисление()

Имя параметра Тип Описание
Переменная* Перечисление.* Имя ранее объявленной переменной, которая содержит значение перечисления. Может содержать начальное значение для вывода в диалоге ввода
Строка Имя ранее объявленной переменной, которая содержит название вида перечисления, как оно задано в конфигураторе
Подсказка* Строка Текст заголовка диалога ввода перечисления. Значение по умолчанию: «Ввод значения»
Таймаут Число Время ожидания реакции пользователя в секундах. По истечении указанного времени диалог ввода автоматически закрывается. Если значение равно 0 (нулю) или не указано, время ожидания не ограничено. Значение по умолчанию: 0
* — обязательный параметр

Тип возвращаемого значения

Число

Описание вариантов возвращаемых значений:

1 — значение введено (нажата кнопка «ОК»)
0 — значение не введено (окно закрыто крестиком или нажата кнопка «Отмена»)
-1 — наступил таймаут (истекло время ожидания)

Описание

Функция ВвестиПеречисление() позволяет пользователю ввести значение перечисления, настроенного в конфигурации. Вид вводимого перечисления определяется параметрами функции.

Диалог ввода перечисления на платформе 1С:Предприятие 7.7

Внимание!
Поскольку функция ВвестиПеречисление() открывает диалог ввода в модальном режиме, избегайте ее использования в модуле проведения документов, а также в пределах открытой транзакции в многопользовательском режиме работы 1С:Предприятие 7.7

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

Пример кода с использованием функции ВвестиПеречисление()

Перем ВыбЗначение;

//задаем значение перечисления по умолчанию
ВыбЗначение = Перечисление.ЦветаТовара.Белый;
	
Если ВвестиПеречисление(ВыбЗначение, "Укажите цвет") = 1 Тогда
	Сообщить(ВыбЗначение); 
КонецЕсли;
	
//задаем строковое имя перечисления
ВыбЗначение = "ЦветаТовара";

Если ВвестиПеречисление(ВыбЗначение, "Укажите цвет") = 1 Тогда
        Сообщить(ВыбЗначение); 
КонецЕсли;

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *