0

Функция ВвестиСтроку

Функция выводит диалоговое окно ввода строки.

Синтаксис

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

число ВвестиСтроку(Переменная, Заголовок, Длина, [Многострочная] [, Таймаут])

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

number InputString(Variable, Title, Length, [isMulti] [, Timeout])

Описание параметров

Описание параметров функции ВвестиСтроку()

Имя параметра Тип Описание
Переменная* Строка Имя ранее объявленной переменной, в которую будет помещено введенное значение. Может содержать начальное значение для вывода в диалоге ввода
Заголовок* Строка Текст заголовка диалога ввода строки. Значение по умолчанию: «Ввод значения»
Длина* Число Ограничение длины вводимой строки. Необходимо указать значение, отличное от нуля
Многострочная Число Режим ввода многострочного значения.

Варианты значения параметра
= 1 ввод многострочного текста с разделителями строк
= 0 ввод одной строки (значение по умолчанию)
Таймаут Число Время ожидания реакции пользователя в секундах. По истечении указанного времени диалог ввода автоматически закрывается. Если значение равно 0 (нулю) или не указано, время ожидания не ограничено. Значение по умолчанию: 0
* — обязательный параметр

Тип возвращаемого значения

Число

1 — значение введено (нажата кнопка «ОК»)
0 — значение не введено (окно закрыто крестиком или нажата кнопка «Отмена»)
-1 — наступил таймаут (истекло время ожидания)

Описание

Функция ВвестиСтроку() запрашивает у пользователя строковые данные, показывая диалог ввода строки.

Диалог ввода строки на платформе 1С:Предприятие 7.7

Кроме того, с помощью этой функции можно вывести диалог ввода многострочного текста.

Диалог ввода многострочного текста на платформе 1С:Предприятие 7.7

Внимание!
Поскольку функция ВвестиСтроку() открывает модальное окно, избегайте ее использования в модуле проведения документов, а также в пределах открытой транзакции в многопользовательском режиме работы 1С:Предприятие 7.7

Пример использования

Пример кода с использованием функции ВвестиСтроку()

Перем ИмяСотрудника;
	
Если ВвестиСтроку(ИмяСотрудника, "Введите Ваше имя", 25) = 1 Тогда
    Сообщить("Имя сотрудника: " + ИмяСотрудника);
КонецЕсли;

//результат:
//  Имя сотрудника: Иван

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

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