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