Расширение поля формы для поля ввода.КнопкаСоздания

Свойства · CreateButton

Тип: Булево, Неопределено. Содержит режим отображения кнопки "Создание" в выпадающем списке поля.

Полное описание, параметры и ограничения

Расширение поля формы для поля ввода.КнопкаСоздания (Form field extension for a text box.CreateButton)

Расширение поля формы для поля ввода (Form field extension for a text box)

КнопкаСоздания (CreateButton)

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

Использование:
Чтение и запись.
Описание:
Тип: Булево, Неопределено.
Содержит режим отображения кнопки "Создание" в выпадающем списке поля.
Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Изменение свойства на клиенте может потребовать обращения к серверу.

Примечание:
Если значение Неопределено, то видимость кнопки определяет значение свойства СозданиеПриВводе реквизита.
Использование в версии:

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

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

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

Создать поле цены с границами, регулированием и отдельной проверкой

Учебная цена начинается с 12.34. Ограничиваем ввод диапазоном 0–9999.99, показываем формат редактирования и не подменяем проверку данных оформлением поля.

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

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

Подготовка

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

  2. Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.

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

  4. Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Новые = Новый Массив;
    ТипРеквизита = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(12, 2));
    Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
    ЭтаФорма.ИзменитьРеквизиты(Новые);
    ЭтаФорма.ЗначениеПримера = 12.34;
    Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
    Поле.Вид = ВидПоляФормы.ПолеВвода;
    Поле.ПутьКДанным = "ЗначениеПримера";
    Поле.Заголовок = "Учебная цена";
    Поле.МинимальноеЗначение = 0;
    Поле.МаксимальноеЗначение = 9999.99;
    Поле.КнопкаРегулирования = Истина;
    Поле.КнопкаОчистки = Истина;
    Поле.КнопкаВыбора = Ложь;
    Поле.КнопкаОткрытия = Ложь;
    Поле.КнопкаСоздания = Ложь;
    Поле.ФорматРедактирования = "ЧДЦ=2; ЧН=0";
    Поле.ВыделятьОтрицательные = Истина;
    Поле.Ширина = 18;
    Поле.ЦветТекста = Новый Цвет(25, 45, 70);

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

&НаКлиенте
Процедура УчебноеДействие(Команда)
    Если ЗначениеПримера < 0 Или ЗначениеПримера > 9999.99 Тогда
        Сообщить("Цена должна быть от 0 до 9999.99. Обработка не выполнена.");
        Возврат;
    КонецЕсли;
    Сообщить("Допустимая учебная цена: " + Формат(ЗначениеПримера, "ЧДЦ=2; ЧН=0"));
    Сообщить("Цена никуда не записана");
КонецПроцедуры

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

  1. Реквизит с числовыми квалификаторами хранит значение с двумя дробными разрядами. Поле — только интерфейс для этого реквизита.

  2. МинимальноеЗначение и МаксимальноеЗначение ограничивают интерактивное поле. КнопкаРегулирования включает стандартные стрелки изменения числа.

  3. Неиспользуемые кнопки выбора, создания и открытия скрываем: это простое число, не ссылка на справочник.

  4. ФорматРедактирования задаёт вид текста, а не алгоритм расчёта НДС или суммы документа.

  5. Команда отдельно проверяет диапазон значения до дальнейшей обработки. Серверные бизнес-операции должны повторять проверку перед записью.

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

  1. Начальная цена 12.34 показана в принятом региональными настройками формате числа.

  2. Введите 0 и 9999.99: проверка разрешает оба граничных значения.

  3. Проверьте стрелки регулирования и попытку ручного ввода отрицательной цены/10000. Не должно быть записи рабочего документа.

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

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

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

  1. Ноль здесь разрешён: ЗначениеЗаполнено не подходит как единственная проверка цены.

  2. Цвет выделения отрицательных не является защитой от некорректного значения.

  3. Внешние данные могут попасть в реквизит без интерактивного поля, поэтому ограничения интерфейса не заменяют серверную проверку.

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

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

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

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

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