Вызывает диалог для ввода строки. При вызове метода в веб-клиенте генерируется исключение.
Синтаксис
ВвестиСтроку(<Строка>, <Подсказка>, <Длина>, <Многострочность>)Примеры платформы
Текст = "";
Подсказка = "Введите текст напоминания";
Если ВвестиСтроку(Текст, Подсказка, 0, Истина) Тогда
КонецЕсли;Полное описание, параметры и ограничения
Глобальный контекст.ВвестиСтроку (Global context.InputString)
Глобальный контекст (Global context)
ВвестиСтроку (InputString)
Доступен, начиная с версии 8.0.
Синтаксис:
ВвестиСтроку(<Строка>, <Подсказка>, <Длина>, <Многострочность>)
Параметры:
<Строка> (обязательный)
Тип: Строка.
Доступная в модуле переменная. В эту переменную будет помещена введенная в диалоге строка. Начальное значение переменной будет использовано в качестве начального значения в диалоге.
<Подсказка> (необязательный)
Тип: Строка.
Текст заголовка окна диалога ввода строки. Может использоваться в качестве подсказки пользователю.
Значение по умолчанию: Пустая строка.
<Длина> (необязательный)
Тип: Число.
Длина вводимой строки. Если параметр не указан, то строка неограниченной длины.
Значение по умолчанию: 0.
<Многострочность> (необязательный)
Тип: Булево.
Определяет режим ввода многострочного текста: Истина - ввод многострочного текста с разделителями строк; Ложь - ввод простой строки.
Значение по умолчанию: Ложь.
Возвращаемое значение:
Тип: Булево.
Истина - строка введена; Ложь - пользователь отказался от ввода строки.
Описание:
Вызывает диалог для ввода строки.
При вызове метода в веб-клиенте генерируется исключение.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).
Примечание:
Если для конфигурации свойство РежимИспользованияМодальности установлено в НеИспользовать, следует использовать метод ПоказатьВводСтроки.
Пример:
Текст = "";
Подсказка = "Введите текст напоминания";
Если ВвестиСтроку(Текст, Подсказка, 0, Истина) Тогда
// запомнить текст напоминания
КонецЕсли;
См. также:
Глобальный контекст, метод ВвестиСтрокуАсинх
Использование в версии:
Доступен, начиная с версии 8.0.
Описание изменено в версии 8.3.18.
Методическая информация
Практические примеры
ВвестиСтроку: показать локальную строку после булевого подтверждения
В собственной совместимой базе получаем название через изменённую локальную переменную. Принято отвечает на вопрос OK/Отмена, а не содержит название.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В отдельной учебной базе платформы 8.5.1.1343 создайте внешнюю обработку УчебнаяФорма85 с пустой управляемой основной формой. Используйте тонкий клиент Windows.
В свойствах формы → События назначьте ПриСозданииНаСервере. Вставьте полный модуль урока, включая клиентские и серверные помощники, на уровне модуля.
Не создавайте вручную ЗначениеПримера, ПолеПримера и кнопку: код создаёт их полностью. Каждый урок запускайте в отдельной копии своей формы.
Сохраните свою EPF и откройте её в учебной базе. Собственное количество начинается с 3, цена книги задана в коде как 250; исходный расчёт равен 750.
Связанный реквизит помечен как СохраняемыеДанные для изучения поведения формы. Это признак реквизита формы, а не автоматическая запись книги, файла или документа в базу.
Команда расчёта имеет ИзменяетСохраняемыеДанные = Ложь. Уроки изменяют только свой интерфейс и значения собственной формы, не конфигурацию и не рабочие данные.
Запуск и вид в 1С не проверены. Компоновку, сочетания клавиш и расположение команд осмотрите вручную в указанном клиенте; не переносите настройки на рабочие формы без отдельной проверки.
В этой партии каждое окно ввода запускает собственная кнопка УчебноеДействие. Изучайте один полный модуль за раз; никакие значения ввода не исполняются как код.
Только для синхронного варианта создайте отдельную пустую учебную конфигурацию с техническим именем УчебныеДиалоги85 и заранее разрешённой модальностью. Читайте её режим в конфигураторе; не меняйте рабочую базу ради урока. При ином имени или НеИспользовать пример откажется до диалога.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(2, 0, ДопустимыйЗнак.Неотрицательный));
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита, "", "Количество книг", Истина));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = 3;
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Количество собственных книг";
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Выполнить собственный учебный шаг";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
#Если ВебКлиент Тогда
Сообщить("Синхронный урок не выполняется в веб-клиенте; используйте обратный вызов");
Возврат;
#Иначе
Если Не РазрешёнСобственныйСинхронныйВвод() Тогда
Сообщить("Синхронный ввод недоступен для этого собственного стенда; настройки базы не менялись");
Возврат;
КонецЕсли;
ДоВвода = ЗначениеПримера;
Введено = "Книга";
Принято = ВвестиСтроку(Введено, "Название собственных книг: не более 32 символов", 32, Ложь);
Если Не Принято Тогда
Сообщить("Отмена: собственные данные не менялись");
Возврат;
КонецЕсли;
Если Введено = Неопределено Тогда
Сообщить("Отмена: собственные данные не менялись");
Возврат;
КонецЕсли;
Если ЗначениеПримера <> ДоВвода Тогда
Сообщить("Количество изменилось за время диалога. Повторите ввод для актуальной заявки");
Возврат;
КонецЕсли;
Если ТипЗнч(Введено) <> Тип("Строка") Тогда
ВызватьИсключение "Название должно быть строкой";
КонецЕсли;
Название = СокрЛП(Введено);
Если ПустаяСтрока(Название) Или СтрДлина(Название) > 32 Тогда
ВызватьИсключение "Для собственной подписи нужно непустое название длиной до 32 символов";
КонецЕсли;
Если СтрНайти(Название, Символы.ПС) > 0 Или СтрНайти(Название, Символы.ВК) > 0 Тогда
ВызватьИсключение "В этом уроке название должно быть однострочным";
КонецЕсли;
ПроверитьСобственноеКоличество();
Сумма = ЗначениеПримера * 250;
Элементы.ПолеПримера.Заголовок = "Количество: " + Название;
Сообщить(Сумма / 250 = ЗначениеПримера);
Сообщить(Элементы.ПолеПримера.Заголовок = "Количество: " + Название);
Сообщить(СтрШаблон("%1: %2 шт.; собственная сумма %3", Название, ЗначениеПримера, Сумма));
#КонецЕсли
КонецПроцедуры
&НаКлиенте
Процедура ПроверитьСобственноеКоличество()
Если ТипЗнч(ЗначениеПримера) <> Тип("Число") Тогда
ВызватьИсключение "Собственное количество должно быть числом";
КонецЕсли;
Если ЗначениеПримера < 1 ИЛИ ЗначениеПримера > 10 ИЛИ ЗначениеПримера <> Цел(ЗначениеПримера) Тогда
ВызватьИсключение "Нужно собственное целое количество от 1 до 10";
КонецЕсли;
КонецПроцедуры
&НаСервереБезКонтекста
Функция РазрешёнСобственныйСинхронныйВвод()
Возврат Метаданные.РежимИспользованияМодальности <> Метаданные.СвойстваОбъектов.РежимИспользованияМодальности.НеИспользовать;
КонецФункции
Разбор по шагам
Проверить имя своей конфигурации и режим модальности, исключить веб-клиент синхронной ветки.
Подготовить отдельную строку Введено=Книга. ВвестиСтроку может изменить именно эту переменную, но до подтверждения она не присваивается заголовку.
При Принято=Ложь выйти без изменений. При Истина читать Введено, а не преобразовывать Булево в название.
Проверить актуальное количество и нормализованное название: непустое, не больше 32 символов, без переводов строк.
Назначить подпись своего поля и рассчитать числовую сумму. Ни режим базы, ни рабочие товары не изменяются.
Как проверить результат
OK с Азбука: две Истина, сумма 750, новое название только в собственной подписи. Отмена не изменяет её.
В иной конфигурации/при НеИспользовать диалог не вызывается. Не включайте модальность рабочей базы для обхода проверки.
Ожидаемый результат
Булево управление и фактический строковый результат разделены на законченной собственной задаче.
На что обратить внимание
ВвестиСтроку в веб-клиенте генерирует исключение, несмотря на упоминание веб-клиента в перечне доступности: учитывается явное примечание.
Начальное название Книга задано явно; неизвестный реквизит чужой формы не требуется.
Обрезка строки и проверка количества не являются записью номенклатуры в базу.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.