Тип: Строка. Содержит текущий текст редактирования в поле ввода. При размещении поля в таблице, если редактор не активен, содержит пустую строку.
Полное описание, параметры и ограничения
Расширение поля формы для поля ввода.ТекстРедактирования (Form field extension for a text box.EditText)
Расширение поля формы для поля ввода (Form field extension for a text box)
ТекстРедактирования (EditText)
Доступен, начиная с версии 8.2.
Использование:
Только чтение.
Описание:
Тип: Строка.
Содержит текущий текст редактирования в поле ввода.
При размещении поля в таблице, если редактор не активен, содержит пустую строку.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Обновить текст поля из значения реквизита
Разделяем данные формы и текст редактора: команда присваивает свою строку, затем явно обновляет текст поля.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.
Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.
Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("Строка");
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = "Черновик";
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Обновить текст поля из значения реквизита";
Поле.ОбновлениеТекстаРедактирования = ОбновлениеТекстаРедактирования.НеИспользовать;
Поле.Ширина = 40;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить свой пример";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Поле = Элементы.ПолеПримера;
ЗначениеПримера = "Подготовлено к проверке";
Поле.ОбновитьТекстРедактирования();
Сообщить(ЗначениеПримера = "Подготовлено к проверке");
Сообщить(Поле.ТекстРедактирования = "Подготовлено к проверке");
Сообщить(Поле.ОбновлениеТекстаРедактирования = ОбновлениеТекстаРедактирования.НеИспользовать);
КонецПроцедуры
Разбор по шагам
Реквизит создаётся на сервере, а команда выполняется на клиенте уже открытой формы.
НеИспользовать отключает автоматическое обновление текста при установке значения в соответствующих режимах совместимости.
ОбновитьТекстРедактирования обновляет отображение из данных; метод не пытается получить новое значение из прежнего текста.
ТекстРедактирования доступен на клиенте только для чтения: ему не присваивается строка.
Проверяем и собственное значение, и текст самостоятельного поля. Это не вызов записи в базу.
Как проверить результат
После нажатия виден текст Подготовлено к проверке; три сравнения Истина.
Повторное нажатие безопасно: устанавливается та же собственная строка.
Ожидаемый результат
Показано направление обновления: значение реквизита → текст редактора.
На что обратить внимание
В совместимости Версия8_2_13 свойство режима не влияет на поведение, но явный метод не зависит от режима совместимости.
В колонке таблицы неактивный редактор может вернуть пустой ТекстРедактирования; урок намеренно использует отдельное поле.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.