0

Функция ВвестиЗначение

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

Синтаксис

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

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

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

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

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

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