Тип: Булево, Неопределено. Содержит признак наличия/отсутствия кнопки открытия значения поля. Неопределено - автоматическое определение.
Полное описание, параметры и ограничения
Расширение поля формы для поля ввода.КнопкаОткрытия (Form field extension for a text box.OpenButton)
Расширение поля формы для поля ввода (Form field extension for a text box)
КнопкаОткрытия (OpenButton)
Доступен, начиная с версии 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. Не должно быть записи рабочего документа.
Ожидаемый результат
Создано понятное поле числового ввода с диапазоном и самостоятельной проверкой значения.
На что обратить внимание
Ноль здесь разрешён: ЗначениеЗаполнено не подходит как единственная проверка цены.
Цвет выделения отрицательных не является защитой от некорректного значения.
Внешние данные могут попасть в реквизит без интерактивного поля, поэтому ограничения интерфейса не заменяют серверную проверку.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Настроить две метки и правила интерактивного ввода
Книга и Ручка находятся в собственном СписокЗначений. Показываем флажки выбора, запрещаем интерактивные повторы и пустые значения.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.
Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.
Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("СписокЗначений");
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = Новый СписокЗначений;
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Учебные метки";
ЭтаФорма.ЗначениеПримера.Добавить("book", "Книга");
ЭтаФорма.ЗначениеПримера.Добавить("pen", "Ручка");
Поле.РасширенноеРедактированиеМножественныхЗначений = Истина;
Поле.РазрешитьДублированиеМножественныхЗначений = Ложь;
Поле.РазрешитьВводПустыхМножественныхЗначений = Ложь;
Поле.ГиперссылкаМножественныхЗначений = Ложь;
Поле.КнопкаОткрытия = Истина;
Поле.Ширина = 60;
Поле.СписокВыбора.Добавить("book", "Книга");
Поле.СписокВыбора.Добавить("pen", "Ручка");
Поле.СписокВыбора.Добавить("pencil", "Карандаш");
Поле.КнопкаВыпадающегоСписка = Истина;
Поле.ОтображатьФлажкиВВыпадающемСпискеПриВводеМножественныхЗначений = Истина;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить учебные метки";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Если ЗначениеПримера.Количество() <> 2 Тогда
Сообщить("Для проверки исходных двух меток переоткройте свою форму");
Возврат;
КонецЕсли;
Книга = ЗначениеПримера.НайтиПоЗначению("book");
Ручка = ЗначениеПримера.НайтиПоЗначению("pen");
Если Книга = Неопределено Или Ручка = Неопределено Тогда
ВызватьИсключение "Не найдены две собственные метки book и pen";
КонецЕсли;
Поле = Элементы.ПолеПримера;
Сообщить(Книга.Представление = "Книга" И Ручка.Представление = "Ручка");
Сообщить(Не Поле.РазрешитьДублированиеМножественныхЗначений);
Сообщить(Не Поле.РазрешитьВводПустыхМножественныхЗначений);
Сообщить(Поле.ОтображатьФлажкиВВыпадающемСпискеПриВводеМножественныхЗначений);
Сообщить(Поле.СписокВыбора.Количество() = 3);
КонецПроцедуры
Разбор по шагам
Тип реквизита — СписокЗначений; поле автоматически работает с множественными значениями.
book и pen — значения, Книга и Ручка — представления. Карандаш пока есть только в списке возможного выбора.
РасширенноеРедактированиеМножественныхЗначений разрешает ввод непосредственно внутри поля.
Запрет дубликатов проверяет интерактивное добавление и стандартный диалог редактирования списка, а не произвольный серверный код.
Команда проверяет исходные две метки и настройки. Если пользователь изменил набор, предлагается переоткрыть учебную форму.
Как проверить результат
На исходных двух метках пять сообщений Истина.
В выпадающем списке видны флажки; попробуйте добавить Карандаш и затем вернуть исходные две метки.
Повторное интерактивное добавление Книга не должно создавать второй book.
Ожидаемый результат
Множественные значения и варианты выбора показаны как два разных списка.
На что обратить внимание
Свойства множественных значений требуют платформу не ниже 8.3.23; урок предназначен для установленной 8.5.1.
Не принимайте запрет дублирования в интерфейсе за универсальную серверную проверку списка.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.