Тип: Строка. Содержит форматную строку. Используется при редактировании текста.
Полное описание, параметры и ограничения
Расширение поля формы для поля ввода.ФорматРедактирования (Form field extension for a text box.EditFormat)
Расширение поля формы для поля ввода (Form field extension for a text box)
ФорматРедактирования (EditFormat)
Доступен, начиная с версии 8.2.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Содержит форматную строку. Используется при редактировании текста.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Создать поле цены с границами, регулированием и отдельной проверкой
Учебная цена начинается с 12.34. Ограничиваем ввод диапазоном 0–9999.99, показываем формат редактирования и не подменяем проверку данных оформлением поля.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.
Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.
Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = 12.34;
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Учебная цена";
Поле.МинимальноеЗначение = 0;
Поле.МаксимальноеЗначение = 9999.99;
Поле.КнопкаРегулирования = Истина;
Поле.КнопкаОчистки = Истина;
Поле.КнопкаВыбора = Ложь;
Поле.КнопкаОткрытия = Ложь;
Поле.КнопкаСоздания = Ложь;
Поле.ФорматРедактирования = "ЧДЦ=2; ЧН=0";
Поле.ВыделятьОтрицательные = Истина;
Поле.Ширина = 18;
Поле.ЦветТекста = Новый Цвет(25, 45, 70);
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить учебную цену";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Если ЗначениеПримера < 0 Или ЗначениеПримера > 9999.99 Тогда
Сообщить("Цена должна быть от 0 до 9999.99. Обработка не выполнена.");
Возврат;
КонецЕсли;
Сообщить("Допустимая учебная цена: " + Формат(ЗначениеПримера, "ЧДЦ=2; ЧН=0"));
Сообщить("Цена никуда не записана");
КонецПроцедуры
Разбор по шагам
Реквизит с числовыми квалификаторами хранит значение с двумя дробными разрядами. Поле — только интерфейс для этого реквизита.
МинимальноеЗначение и МаксимальноеЗначение ограничивают интерактивное поле. КнопкаРегулирования включает стандартные стрелки изменения числа.
Неиспользуемые кнопки выбора, создания и открытия скрываем: это простое число, не ссылка на справочник.
ФорматРедактирования задаёт вид текста, а не алгоритм расчёта НДС или суммы документа.
Команда отдельно проверяет диапазон значения до дальнейшей обработки. Серверные бизнес-операции должны повторять проверку перед записью.
Как проверить результат
Начальная цена 12.34 показана в принятом региональными настройками формате числа.
Введите 0 и 9999.99: проверка разрешает оба граничных значения.
Проверьте стрелки регулирования и попытку ручного ввода отрицательной цены/10000. Не должно быть записи рабочего документа.
Ожидаемый результат
Создано понятное поле числового ввода с диапазоном и самостоятельной проверкой значения.
На что обратить внимание
Ноль здесь разрешён: ЗначениеЗаполнено не подходит как единственная проверка цены.
Цвет выделения отрицательных не является защитой от некорректного значения.
Внешние данные могут попасть в реквизит без интерактивного поля, поэтому ограничения интерфейса не заменяют серверную проверку.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Отличить шаг выбора времени от исходной даты
Исходная дата содержит 13:47:12. Календарь предлагает интервалы 15 минут, но установка режима сама по себе не округляет реквизит.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.
Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.
Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("Дата", , , Новый КвалификаторыДаты(ЧастиДаты.ДатаВремя));
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = Дата(2026, 10, 4, 13, 47, 12);
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Отличить шаг выбора времени от исходной даты";
Поле.ФорматРедактирования = "ДФ='dd.MM.yyyy HH:mm:ss'";
Поле.КнопкаВыбора = Истина;
Поле.РежимВыбораВремени = РежимВыбораВремени.Интервал15Минут;
Поле.РазмерТекста = РазмерТекстаПоляВвода.Обычный;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить свой пример";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Поле = Элементы.ПолеПримера;
Сообщить(Поле.РежимВыбораВремени = РежимВыбораВремени.Интервал15Минут);
Сообщить(Поле.РазмерТекста = РазмерТекстаПоляВвода.Обычный);
Сообщить(СтрШаблон("Фактическая дата: %1; час %2; минута %3; секунда %4", ЗначениеПримера, Час(ЗначениеПримера), Минута(ЗначениеПримера), Секунда(ЗначениеПримера)));
Сообщить(ЗначениеПримера = Дата(2026, 10, 4, 13, 47, 12));
КонецПроцедуры
Разбор по шагам
КвалификаторыДаты разрешают и дату, и время. ФорматРедактирования также содержит время.
РежимВыбораВремени задаёт способ интерактивного выбора в календаре интерфейса 8.5.
При открытии календаря его надпись Выбрано округляется вниз до соответствующего интервала; секунды становятся 00.
Само свойство режима не присваивает округлённую дату реквизиту. Значение меняется после интерактивного подтверждения.
Команда сообщает фактические части даты и отдельно проверяет исходное значение.
Как проверить результат
Не открывая календарь: два сравнения Истина, диагностика 13 / 47 / 12, последнее сравнение Истина.
В интерфейсе 8.5 откройте календарь и подтвердите первоначально предложенное время: ожидается 13:45:00; последнее сравнение станет Ложь.
Для повторения исходной даты переоткройте форму.
Ожидаемый результат
Интерфейсное округление отделено от хранимой в форме даты.
На что обратить внимание
РежимВыбораВремени и РазмерТекста применяются только в интерфейсе Версия 8.5.
Если тип или формат не содержит времени, панель выбора времени не отображается.
Ручная проверка календаря не заменяет проверку серверных правил округления в рабочем документе.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.