Функция выводит диалоговое окно для ввода значения произвольного типа
Синтаксис
Функция ВвестиЗначение() имеет следующий синтаксис:
число ВвестиЗначение(Переменная, [Подсказка], Тип, [Длина] [, Точность])
А также альтернативный англоязычный синтаксис:
number InputValue(Variable, [Title], Type, Length [, Precision])
Описание параметров
Описание параметров функции ВвестиЗначение()
| Имя параметра | Тип | Описание |
|---|---|---|
| Переменная* | Произвольный | Имя ранее объявленной переменной, в которую будет помещено выбранное значение. Может содержать начальное значение для вывода в диалоге ввода |
| Подсказка | Строка | Текст заголовка диалога ввода числа. Значение по умолчанию: «Ввод значения» |
| Тип* | Строка | Строковое представление вводимого типа |
| Длина | Число | Ограничение длины вводимого значения для типов Строка и Число |
| Точность | Число | Ограничение точности вводимого значения (количества знаков после десятичной точки) для типа Число |
| * — обязательный параметр | ||
Тип возвращаемого значения
Число
Описание вариантов возвращаемых значений:
| 1 | — значение введено (нажата кнопка «ОК») |
| 0 | — значение не введено (окно закрыто крестиком или нажата кнопка «Отмена») |
Описание
Функция ВвестиЗначение() предназначена для вызова диалога ввода значений произвольного типа. Тип вводимого значения определяется параметрами функции. Хочу заметить, что с помощью этой функции можно вводить значения не только простых типов, но и выбирать элементы из справочников, а также документы из общего журнала. Подробнее типы данных платформы 1С:Предприятие 7.7 рассмотрены в главе «Типы данных встроенного языка».
Функция ВвестиЗначение() не раполагает параметрами ограничения времени реакции пользователя. Поэтому, по возможности, рекомендую воздержаться от ее применения и использовать аналоги: ВвестиЧисло(), ВвестиСтроку(),ВвестиДату() и др.
Поскольку функция
ВвестиЗначение() открывает диалог ввода в модальном режиме, избегайте ее использования в модуле проведения документов, а также в пределах открытой транзакции в многопользовательском режиме работы 1С:Предприятие 7.7Пример использования
Пример кода с использованием функции ВвестиЗначение()
Перем ВыбЗначение; ВыбЗначение = 2000; Если ВвестиЗначение(ВыбЗначение, "Уточните сумму", "Число", 10, 2) = 1 Тогда Сообщить(ВыбЗначение); КонецЕсли; //результат: // 2100.1 ВыбЗначение = Дата(1990, 1, 1); Если ВвестиЗначение(ВыбЗначение, "Введите дату рождения", "Дата") = 1 Тогда Сообщить(ВыбЗначение); КонецЕсли; //результат: // 01.07.1997