Возникает при формировании значения по отредактированному тексту. Например, в момент перехода на другой элемент управления формы, при закрытии формы и т.д.
Синтаксис
ОкончаниеВводаТекста(<Текст>, <ДанныеВыбора>, <ПараметрыПолученияДанных>, <СтандартнаяОбработка>)Полное описание, параметры и ограничения
Расширение поля формы для поля ввода.ОкончаниеВводаТекста (Form field extension for a text box.TextEditEnd)
Расширение поля формы для поля ввода (Form field extension for a text box)
ОкончаниеВводаТекста (TextEditEnd)
Доступен, начиная с версии 8.2.
Синтаксис:
ОкончаниеВводаТекста(<Текст>, <ДанныеВыбора>, <ПараметрыПолученияДанных>, <СтандартнаяОбработка>)
Параметры:
<Текст>
Тип: Строка.
Строка текста, введенная в поле ввода.
<ДанныеВыбора>
Тип: СписокЗначений.
Параметр заполняется списком значений для последующего выбора одного из них и размещения его в поле ввода. Пометки элементов этого списка значений могут использоваться для отметки значений, соответствующих помеченным на удаление объектам. В том случае, если пользователь выберет одно из помеченных значений, система выдаст стандартное предупреждение о выборе помеченного на удаление объекта.
Список может содержать как конкретное значение, так и структуру, в которой может быть указана следующая информация (по именам ключей в структуре):
Значение (Value) - собственно значение или массив значений;
ПометкаУдаления (DeletionMark) - пометка удаления;
Предупреждение (Warning) - текст предупреждения, которое будет показано при выборе элемента из списка значений.
ДополнительныеДанные (AdditionalData) - Произвольные дополнительные данные, которые после выбора будут переданы в обработчик события ОбработкаВыбора.
Если поле ввода редактирует данные типа СписокЗначений или ДанныеФормыКоллекция, то есть находится в режиме ввода множественных значений и включен режим ОтображатьФлажкиВВыпадающемСпискеПриВводеМножественныхЗначений, то передаваемое в элементе списка или в составе структуры значение используется для определения состояния флажка элемента выпадающего списка. Если при этом передать в элементе списка или в составе структуры по ключу Значение (Value) массив значений, состояние флажка будет определяться следующим образом:
Если все значения массива содержатся среди множественных значений, то флажок устанавливается;
Если ни одно значение массива не содержится среди множественных значений, то флажок не устанавливается;
Если только часть значений содержится среди множественных значений, то флажок отображается "серым".
<ПараметрыПолученияДанных>
Тип: Структура, Неопределено.
Содержит параметры поиска, которые будут переданы в метод ПолучитьДанныеВыбора.
Структура, в которой обязательно должны содержаться следующие ключи:
СтрокаПоиска (SearchString) - строка, используемая при поиске данных, Неопределено - осуществляется быстрый выбор;
Отбор (Filter) - отбор, используемый при поиске данных;
ВыборГруппИЭлементов (ChoiceFoldersAndItems) - указывается использование групп и элементов (только для иерархических данных); тип ИспользованиеГруппИЭлементов; параметр может отсутствовать;
СпособПоискаСтроки (StringSearchMode) - указывается способ поиска при вводе по строке; тип СпособПоискаСтрокиПриВводеПоСтроке; параметр может отсутствовать;
ПолнотекстовыйПоискПриВводеПоСтроке (FullTextSearchOnInputByString) - указывается необходимость использования полнотекстового поиска при вводе по строке; тип - ПолнотекстовыйПоискПриВводеПоСтроке; параметр может отсутствовать;
РежимПолученияДанныхВыбора (ChoiceDataGettingMode) - указывает режим запуска поиска. Тип РежимПолученияДанныхВыбораПриВводеПоСтроке; параметр может отсутствовать.
Неопределено - для мобильной платформы.
<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет.
Параметр позволяет отменить стандартное заполнение системой ДанныеВыбора. При этом все действия (отображение списка, предупреждения) выполняются системой на основе возвращенного значения параметра <ДанныеВыбора> независимо от значения параметра <СтандартнаяОбработка>.
Для типов Число, Строка, Дата, если установить данному параметру значение Истина, то выполняется стандартное присвоение значения на основе введенного текста, без использования значения параметра <ДанныеВыбора>. В противном случае поле ввода обрабатывает получаемый в <ДанныеВыбора> список значений аналогично другим типам.
Значение по умолчанию: Истина.
Описание:
Возникает при формировании значения по отредактированному тексту. Например, в момент перехода на другой элемент управления формы, при закрытии формы и т.д.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент).
Примечание:
В обработчике данного события нельзя использовать серверные методы формы с директивой компиляции &НаСервере, а также изменять свойства, которые могут привести к серверному вызову.
Использование в версии:
Доступен, начиная с версии 8.2.
Описание изменено в версии 8.3.23.
Методическая информация
Практические примеры
Убрать крайние пробелы при завершении ввода названия
Нормализованный текст передаётся через контракт данных выбора, не сохраняется преждевременно при каждом нажатии.
Где и как запускать
Клиентский модуль собственной управляемой формы. Параметр Элемент передаёт платформа; он уже включён в сигнатуру.
Подготовка
Создайте внешнюю учебную обработку с управляемой формой. Реквизиты формы Наименование (Строка 100), Количество (Число 10.0), Статус (Строка 200); выведите их полями ввода.
Имя строкового поля Наименование, числового поля Количество. Обработчик назначается в свойствах именно элемента формы на вкладке События, не в модуле объекта обработки.
Основной код вставляйте на уровне модуля управляемой формы. Он выполняется на клиенте и не обращается к рабочим справочникам.
Событие ОкончаниеВводаТекста назначьте процедуре из примера. Поле редактирует единичную строку, не список множественных значений.
&НаКлиенте
Процедура НаименованиеОкончаниеВводаТекста(Элемент, Текст, ДанныеВыбора, ПараметрыПолученияДанных, СтандартнаяОбработка)
ДанныеВыбора = Новый СписокЗначений;
ДанныеВыбора.Добавить(СокрЛП(Текст));
СтандартнаяОбработка = Ложь;
Сообщить("Название подготовлено без крайних пробелов");
КонецПроцедурыРазбор по шагам
Платформа вызывает назначенный обработчик поля ввода.
Нормализованный текст передаётся через контракт данных выбора, не сохраняется преждевременно при каждом нажатии.
Все значения и варианты принадлежат собственной форме.
Как проверить результат
Введите Книга с пробелами по краям и перейдите в другое поле: получается Книга.
Один вариант в ДанныеВыбора используется вместо стандартного преобразования введённой строки.
Ожидаемый результат
Убрать крайние пробелы при завершении ввода названия без обращения к рабочей конфигурации.
На что обратить внимание
Не вызывайте серверные процедуры из этих клиентских обработчиков и не заменяйте ими проверки модуля объекта базы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.