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