ПолеВвода.КнопкаОчистки

Свойства · ClearButton

Тип: Булево. Содержит признак наличия/отсутствия кнопки очистки поля. Истина - кнопка есть.

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

ПолеВвода.КнопкаОчистки (TextBox.ClearButton)

ПолеВвода (TextBox)

КнопкаОчистки (ClearButton)

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

Использование:
Чтение и запись.
Описание:
Тип: Булево.
Содержит признак наличия/отсутствия кнопки очистки поля.
Истина - кнопка есть.
Доступность:

Толстый клиент.

Использование в версии:

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

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

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

Отделить границы ввода количества от проверки кода

Поле ограничивает ввод значениями 0–100. Программно задаём 200 и показываем, почему бизнес-проверка нужна отдельно от свойств элемента.

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

Полный модуль новой обычной формы внешней обработки. Только толстый клиент с обычными формами, не серверный модуль и не управляемая форма.

Подготовка

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

  2. В форме создайте реквизиты УчебноеКоличество (Число 9.0), УчебноеОписание (Строка неограниченной длины), УчебныйСтатус (Строка 20), УчебныйПароль (Строка 100). Добавьте поля ввода ПолеКоличество, ПолеОписание, ПолеСтатуса, ПолеПароля, свяжите их Данные с соответствующими реквизитами.

  3. Добавьте обычную кнопку УчебнаяКоманда. Свяжите её действие и событие ПриОткрытии формы с одноимёнными процедурами. Каждый урок заменяет полный модуль только этой собственной формы.

  4. Рабочие данные не используются. Пароль в примере NOT_A_REAL_SECRET — вымышленная учебная строка; не вводите реальные секреты. Значения нигде не сохраняются и не отправляются.

Процедура ПриОткрытии()
    УчебноеКоличество = 3;
    УчебноеОписание = "Книга" + Символы.ПС + "Ручка";
    УчебныйСтатус = "";
    УчебныйПароль = "NOT_A_REAL_SECRET";
    Поле = ЭтаФорма.ЭлементыФормы.ПолеКоличество;
    Поле.ОграничениеТипа = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный));
    Поле.МинимальноеЗначение = 0;
    Поле.МаксимальноеЗначение = 100;
    Поле.КнопкаРегулирования = Истина;
    Поле.КнопкаВыбора = Ложь;
    Поле.КнопкаОчистки = Истина;
    Поле.ВыбиратьТип = Ложь;
    Поле.ВыделятьОтрицательные = Истина;
    Поле.Формат = "ЧДЦ=0";
КонецПроцедуры

Процедура УчебнаяКоманда(Кнопка)
    Поле = ЭтаФорма.ЭлементыФормы.ПолеКоличество;
    Сообщить(Поле.МинимальноеЗначение = 0 И Поле.МаксимальноеЗначение = 100);
    Сообщить(Поле.ОграничениеТипа.СодержитТип(Тип("Число")));
    УчебноеКоличество = 200;
    Допустимо = УчебноеКоличество >= 0 И УчебноеКоличество <= 100;
    Сообщить(Не Допустимо);
    Если Не Допустимо Тогда
        Сообщить("Своё значение 200 отклонено проверкой кода; ничего не записано");
    КонецЕсли;
    УчебноеКоличество = 3;
    Сообщить(УчебноеКоличество = 3);
    Сообщить("Номер элемента связи по типу: " + Строка(Поле.ЭлементСвязиПоТипу));
КонецПроцедуры

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

  1. ОграничениеТипа ограничивает тип значения интерфейса, МинимальноеЗначение и МаксимальноеЗначение — его диапазон.

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

  3. ВыделятьОтрицательные — оформление, не отдельный запрет отрицательного значения.

  4. Программное присваивание 200 проверяется явным условием. Урок не выдаёт ограничения интерфейса за серверную проверку данных.

  5. Возвращаем 3, значение сохранять некуда. ЭлементСвязиПоТипу только читается и не выдаётся за ссылку на товар.

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

  1. Четыре сравнения Истина и диагностический номер связи.

  2. Попробуйте интерактивный ввод за границами отдельно; это не заменяет условие Допустимо в коде.

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

Границы элемента отделены от проверки программного значения.

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

  1. Не полагайтесь на свойства клиента при проверке данных от другого клиента или API.

  2. Формат ЧДЦ=0 не изменяет числовой тип реквизита.

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

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

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

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

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