Функция выводит диалог выбора значения перечисления
Синтаксис
Функция ВвестиПеречисление() имеет следующий синтаксис:
число ВвестиПеречисление(Переменная, Подсказка [, Таймаут])
А также альтернативный англоязычный синтаксис:
number InputEnum(Variable, Title [, Timeout])
Описание параметров
Описание параметров функции ВвестиПеречисление()
| Имя параметра | Тип | Описание |
|---|---|---|
| Переменная* | Перечисление.* | Имя ранее объявленной переменной, которая содержит значение перечисления. Может содержать начальное значение для вывода в диалоге ввода |
| Строка | Имя ранее объявленной переменной, которая содержит название вида перечисления, как оно задано в конфигураторе | |
| Подсказка* | Строка | Текст заголовка диалога ввода перечисления. Значение по умолчанию: «Ввод значения» |
| Таймаут | Число | Время ожидания реакции пользователя в секундах. По истечении указанного времени диалог ввода автоматически закрывается. Если значение равно 0 (нулю) или не указано, время ожидания не ограничено. Значение по умолчанию: 0 |
| * — обязательный параметр | ||
Тип возвращаемого значения
Число
Описание вариантов возвращаемых значений:
| 1 | — значение введено (нажата кнопка «ОК») |
| 0 | — значение не введено (окно закрыто крестиком или нажата кнопка «Отмена») |
| -1 | — наступил таймаут (истекло время ожидания) |
Описание
Функция ВвестиПеречисление() позволяет пользователю ввести значение перечисления, настроенного в конфигурации. Вид вводимого перечисления определяется параметрами функции.
Внимание!
Поскольку функция
Поскольку функция
ВвестиПеречисление() открывает диалог ввода в модальном режиме, избегайте ее использования в модуле проведения документов, а также в пределах открытой транзакции в многопользовательском режиме работы 1С:Предприятие 7.7Пример использования
Пример кода с использованием функции ВвестиПеречисление()
Перем ВыбЗначение; //задаем значение перечисления по умолчанию ВыбЗначение = Перечисление.ЦветаТовара.Белый; Если ВвестиПеречисление(ВыбЗначение, "Укажите цвет") = 1 Тогда Сообщить(ВыбЗначение); КонецЕсли; //задаем строковое имя перечисления ВыбЗначение = "ЦветаТовара"; Если ВвестиПеречисление(ВыбЗначение, "Укажите цвет") = 1 Тогда Сообщить(ВыбЗначение); КонецЕсли;