Функция ВВОД_ЗНАЧЕНИЯ
Функция ВВОД_ЗНАЧЕНИЯ полностью эквивалентна функции ВВЕСТИ_ЗНАЧЕНИЕ за исключением того, что не дает пользователю возможности прервать расчет. То есть вместо кнопки Стоп содержит кнопку Отмена.
При нажатии кнопки "Отмена" функция возвращает:
- для чисел и радиокнопок: 0;
- для строк: "";
- для дат: 01.01.1980;
- для времени: 00:00:00.
Более точно определить была нажата кнопка ОК или Отмена позволяет вызоыв функции АТРИБУТ("результат_диалога").
Данная функция позволяет вводить значения следующих типов:
- логическое значение (ДА, НЕТ);
- дата;
- время;
- выбор из перечисленных значений;
- строка;
- число.
Тип вводимого значения определяется заданным в параметрах функции исходным значением, предлагаемым функцией как значение по умолчанию.
При вводе логического значения диалоговая панель будет содержать кнопки ДА и НЕТ.
При вводе числа или даты можно воспользоваться соответственно встроенным калькулятором или календарем, вызвав их клавишей F2 или нажав кнопку, расположенную справа от поля ввода.
Если в функции задан набор вариантов, то диалоговая панель будет содержать радиокнопки с зависимой фиксацией, соответствующие каждому из вариантов.
Для ввода многострочного текста можно воспользоваться функцией ВВОД_ТЕКСТА.
ФУНКЦИЯ *: ВВОД_ЗНАЧЕНИЯ (ТИП_СТРОКА: запрос
<исходное_значение> [; ТИП_ЧИСЛО: дополнительные_параметры])
Параметры
- запрос
- Строка, содержащая вопрос.
- исходное_значение
- Значение, которое будет предложено по умолчанию. Исходное значение может быть задано как:
- логическое значение (например, ДА);
- дата (например, 12.07.2020);
- время (например, 13:30:00);
- набор вариантов (например, ["Вариант1", "Вариант2", "Вариант3"]).
- строка (например, "Введите значение НДС");
- число (например, 120596).
- дополнительные_параметры
- В зависимости от типа параметра исходное_значение возможны следующие дополнительные параметры:
- Если исходное значение задано как набор вариантов, то в качестве дополнительного параметра выступает число, обозначающее номер значения, предложенного по умолчанию;
- При вводе исходного значения типа строка в качестве дополнительного параметра указывается число, обозначающее максимально допустимое количество символов строки;
- При вводе значения типа число можно задать диапазон значений. Задаются один или два дополнительных параметра, обозначающих минимальное и максимальное значение. Если задан только один параметр, то он считается максимальным, а минимальное значение равно нулю.
Возвращаемое значение
Введенное значение, тип которого соответствует типу исходного значения, заданного в параметрах функции. В случае перечисления вариантов результатом является номер выбранного варианта.
Пример использования
Ниже приведен пример, в котором с помощью функции ВВОД_ЗНАЧЕНИЯ вводится номер записи в базе данных, а затем осуществляется переход на эту запись.
номер = ВВОД_ЗНАЧЕНИЯ ("Введите номер: ", 1, 1, 100)
БД_ПЕРЕЙТИ (номер)
