Глобальный контекст.ПоказатьВводСтроки

Методы · ShowInputString

Вызывает диалог для ввода строки, при этом не ожидает завершения ввода.

Синтаксис

ПоказатьВводСтроки(<ОписаниеОповещенияОЗавершении>, <Строка>, <Подсказка>, <Длина>, <Многострочность>)

Примеры платформы

Подсказка = "Введите текст напоминания";
Оповещение = Новый ОписаниеОповещения("ПослеВводаСтроки", , Параметры);
ПоказатьВводСтроки(Оповещение, "", Подсказка, 0, Истина);
&НаКлиенте
Процедура ПослеВводаСтроки(Строка, Параметры) Экспорт
    Если НЕ Строка = Неопределено Тогда
    КонецЕсли;
КонецПроцедуры;
Полное описание, параметры и ограничения

Глобальный контекст.ПоказатьВводСтроки (Global context.ShowInputString)

Глобальный контекст (Global context)

ПоказатьВводСтроки (ShowInputString)

Доступен, начиная с версии 8.3.3.

Синтаксис:
ПоказатьВводСтроки(<ОписаниеОповещенияОЗавершении>, <Строка>, <Подсказка>, <Длина>, <Многострочность>)
Параметры:

<ОписаниеОповещенияОЗавершении> (обязательный)
Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана после закрытия окна ввода строки со следующими параметрами:
<Строка> - введенное значение строки или Неопределено, если пользователь отказался от ввода,

<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.

<Строка> (необязательный)
Тип: Строка.
Начальное значение строки, которое будет использовано в качестве начального значения в окне ввода.

<Подсказка> (необязательный)
Тип: Строка.
Текст заголовка окна диалога ввода строки. Может использоваться в качестве подсказки пользователю.
Значение по умолчанию: Пустая строка.

<Длина> (необязательный)
Тип: Число.
Длина вводимой строки. Если параметр не указан, то строка неограниченной длины.
Значение по умолчанию: 0.

<Многострочность> (необязательный)
Тип: Булево.
Определяет режим ввода многострочного текста: Истина - ввод многострочного текста с разделителями строк; Ложь - ввод простой строки.
Значение по умолчанию: Ложь.
Описание:

Вызывает диалог для ввода строки, при этом не ожидает завершения ввода.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

Пример:

Подсказка = "Введите текст напоминания";
Оповещение = Новый ОписаниеОповещения("ПослеВводаСтроки", , Параметры);
ПоказатьВводСтроки(Оповещение, "", Подсказка, 0, Истина);
//...

&НаКлиенте
Процедура ПослеВводаСтроки(Строка, Параметры) Экспорт
Если НЕ Строка = Неопределено Тогда
// запомнить текст напоминания

КонецЕсли;
КонецПроцедуры;

Использование в версии:

Доступен, начиная с версии 8.3.3.

Описание изменено в версии 8.3.22.

Методическая информация

Практические примеры

ПоказатьВводСтроки: применить своё название после закрытия диалога

Собственное название приходит в экспортный обработчик вместе со снимком количества; маркер позволяет не принять запоздавший ответ.

Где и как запускать

Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.

Подготовка

  1. В отдельной учебной базе платформы 8.5.1.1343 создайте внешнюю обработку УчебнаяФорма85 с пустой управляемой основной формой. Используйте тонкий клиент Windows.

  2. В свойствах формы → События назначьте ПриСозданииНаСервере. Вставьте полный модуль урока, включая клиентские и серверные помощники, на уровне модуля.

  3. Не создавайте вручную ЗначениеПримера, ПолеПримера и кнопку: код создаёт их полностью. Каждый урок запускайте в отдельной копии своей формы.

  4. Сохраните свою EPF и откройте её в учебной базе. Собственное количество начинается с 3, цена книги задана в коде как 250; исходный расчёт равен 750.

  5. Связанный реквизит помечен как СохраняемыеДанные для изучения поведения формы. Это признак реквизита формы, а не автоматическая запись книги, файла или документа в базу.

  6. Команда расчёта имеет ИзменяетСохраняемыеДанные = Ложь. Уроки изменяют только свой интерфейс и значения собственной формы, не конфигурацию и не рабочие данные.

  7. Запуск и вид в 1С не проверены. Компоновку, сочетания клавиш и расположение команд осмотрите вручную в указанном клиенте; не переносите настройки на рабочие формы без отдельной проверки.

  8. В этой партии каждое окно ввода запускает собственная кнопка УчебноеДействие. Изучайте один полный модуль за раз; никакие значения ввода не исполняются как код.

Перем АктивныйЗапрос;

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Новые = Новый Массив;
    ТипРеквизита = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(2, 0, ДопустимыйЗнак.Неотрицательный));
    Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита, "", "Количество книг", Истина));
    ЭтаФорма.ИзменитьРеквизиты(Новые);
    ЭтаФорма.ЗначениеПримера = 3;
    Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
    Поле.Вид = ВидПоляФормы.ПолеВвода;
    Поле.ПутьКДанным = "ЗначениеПримера";
    Поле.Заголовок = "Количество собственных книг";


    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Выполнить собственный учебный шаг";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры

&НаКлиенте
Процедура УчебноеДействие(Команда)
    ДоВвода = ЗначениеПримера;
    Маркер = Новый УникальныйИдентификатор;
    КонтекстВвода = Новый Структура("Маркер,ДоВвода", Маркер, ДоВвода);
    АктивныйЗапрос = Маркер;
    Оповещение = Новый ОписаниеОповещения("ПослеСобственногоВвода", ЭтаФорма, КонтекстВвода);
    Попытка
        ПоказатьВводСтроки(Оповещение, "Книга", "Название собственных книг: не более 32 символов", 32, Ложь);
    Исключение
        АктивныйЗапрос = Неопределено;
        ВызватьИсключение;
    КонецПопытки;
    Сообщить("Запрос ввода сделан; результат обрабатывается только в процедуре завершения");

КонецПроцедуры

&НаКлиенте
Процедура ПроверитьСобственноеКоличество()
    Если ТипЗнч(ЗначениеПримера) <> Тип("Число") Тогда
        ВызватьИсключение "Собственное количество должно быть числом";
    КонецЕсли;
    Если ЗначениеПримера < 1 ИЛИ ЗначениеПримера > 10 ИЛИ ЗначениеПримера <> Цел(ЗначениеПримера) Тогда
        ВызватьИсключение "Нужно собственное целое количество от 1 до 10";
    КонецЕсли;
КонецПроцедуры

&НаКлиенте
Процедура ПослеСобственногоВвода(Введено, ДополнительныеПараметры) Экспорт
    Если Не ЭтаФорма.Открыта() Тогда
        Возврат;
    КонецЕсли;
    Если ДополнительныеПараметры.Маркер <> АктивныйЗапрос Тогда
        Сообщить("Устаревший ответ собственного диалога не применяется");
        Возврат;
    КонецЕсли;
    АктивныйЗапрос = Неопределено;
    ДоВвода = ДополнительныеПараметры.ДоВвода;
    Если Введено = Неопределено Тогда
        Сообщить("Отмена: собственные данные не менялись");
        Возврат;
    КонецЕсли;
    Если ЗначениеПримера <> ДоВвода Тогда
        Сообщить("Количество изменилось за время диалога. Повторите ввод для актуальной заявки");
        Возврат;
    КонецЕсли;
    Если ТипЗнч(Введено) <> Тип("Строка") Тогда
        ВызватьИсключение "Название должно быть строкой";
    КонецЕсли;
    Название = СокрЛП(Введено);
    Если ПустаяСтрока(Название) Или СтрДлина(Название) > 32 Тогда
        ВызватьИсключение "Для собственной подписи нужно непустое название длиной до 32 символов";
    КонецЕсли;
    Если СтрНайти(Название, Символы.ПС) > 0 Или СтрНайти(Название, Символы.ВК) > 0 Тогда
        ВызватьИсключение "В этом уроке название должно быть однострочным";
    КонецЕсли;
    ПроверитьСобственноеКоличество();
    Сумма = ЗначениеПримера * 250;
    Элементы.ПолеПримера.Заголовок = "Количество: " + Название;
    Сообщить(Сумма / 250 = ЗначениеПримера);
    Сообщить(Элементы.ПолеПримера.Заголовок = "Количество: " + Название);
    Сообщить(СтрШаблон("%1: %2 шт.; собственная сумма %3", Название, ЗначениеПримера, Сумма));

КонецПроцедуры

Разбор по шагам

  1. Создать дополнительную структуру и ОписаниеОповещения с владельцем ЭтаФорма. Не назначать результат метода строковой переменной.

  2. ПоказатьВводСтроки вызывается с пятью аргументами: описание, Книга, подсказка, 32, Ложь.

  3. Получить строку и дополнительную структуру в обработчике с двумя параметрами. После подтверждения проверить актуальный маркер и снимок количества.

  4. Отмена и непустое название — разные исходы. Сначала обработать Неопределено, затем проверить строковый тип, пробелы, длину и однострочность.

  5. Применить собственную подпись и пересчитать сумму только после всех проверок. Код завершения не выдаёт факт запроса ввода за факт получения результата.

Как проверить результат

  1. Азбука даёт заголовок Количество: Азбука, две Истина и 750 при исходных трёх книгах.

  2. Отмена оставляет прежний заголовок. Поставьте точку останова в экспортный обработчик и проверьте Введено, ДоВвода и Маркер.

Ожидаемый результат

Получен полноценный пример строкового обратного вызова с защитой собственного текущего состояния.

На что обратить внимание

  1. ПС и ВК проверяются в самой строке результата; этот текст не считается HTML или кодом.

  2. Возвращать Введено из экспортной процедуры не нужно: результат уже получен её параметром.

  3. Кнопка намеренно не отключена навсегда до callback. Если новый запрос заменяет старый, старый ответ не применяется.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.