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