Свойства компонента интерфейса, унаследованного от компонента «ПолеВвода»

Поле для ввода и редактирования данных разных типов.

Иерархия наследования

Компонент (абстрактный)
- ПолеВвода

Свойства

ВыравниваниеСодержимогоПоГоризонтали

Способ выравнивания текста в поле ввода:

Авто — значение ВыравниваниеПоГоризонтали.Начало;
элементы перечисления ВыравниваниеПоГоризонтали — Начало, Центр, Конец, ПоШирине.

ДопустимыеТипы

Дополнительно ограничивает тип значения поля ввода на этапе исполнения кода. Используется только тогда, когда тип параметра нельзя задать с помощью обобщенного типа. Например, если тип задается динамически с помощью вычисляемого выражения.

Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: d78f5166-ddff-41de-9c84-1f28712dae5c
Имя: ФормаОтображенияРезультатаЗапроса
Свойства:
  -
    Имя: МойРезультатЗапроса
    Тип: РезультатЗапроса<Объект>
Наследует:
    Тип: Форма
    Содержимое:
        Тип: ПолеВвода<Объект?>
        ДопустимыеТипы: =[МойРезультатЗапроса.Значение.ПолучитьТип()]
        Значение: =МойРезультатЗапроса.Значение

ДиапазонВыделения

Только чтение. Границы выделенного текста

Заголовок

Заголовок поля ввода

ЗамещающийТекст

Замещающий текст, который отображается внутри поля ввода

Значение

Значение поля ввода. Изменяется при переходе на другой компонент интерфейса. Свойство требует двунаправленной связи с данными

Изображение

Значение типа ДвоичныйОбъект.Ссылка. Ссылка на двоичные данные картинки, которая будет показана в начале поля ввода

Картинка

Картинка, которую использует поле ввода

НастройкиВводаДатыВремени

Настройки редактирования даты и времени. Применяется если поле ввода редактирует значения типов Дата, ДатаВремя, Время, Момент

НастройкиВводаДлительности

Задает настройки ввода длительности. Применяются, если поле ввода редактирует тип Длительность.

НастройкиВводаСсылок

Настройки ввода для отдельных допустимых ссылочных типов

НастройкиВводаСтроки

Настройки редактирования значений типа Строка

Обязательное

Признак того, что в поле должно быть введено значение. Выглядит как красная звездочка перед заголовком. Установка этого признака имеет только визуальное значение и не оказывает никакого влияния на функционирование поля ввода

РежимВыбораИзСписка

Режим выбора из списка:

НеИспользовать — список выбора не используется;
Использовать — можно выбирать значения из списка выбора или вводить любые допустимые значения вручную;
ТолькоЗначенияИзСписка — можно выбирать из списка или вводить вручную только те значения, которые содержатся в списке выбора.

РежимПароля

Признак того, что вводимые символы должны маскироваться символами *

РезервироватьМестоПодСообщение

Указывает — резервировать ли место для сообщений, заданных в свойствах СообщениеОшибка, СообщениеИнформация, СообщениеУспех или СообщениеПредупреждение

РезультатПроверкиДанных

Отображает результат проверки данных в поле ввода. Возможные значения: Успех, Предупреждение, Ошибка, Отсутствует

СообщениеИнформация

Текст, описывающий назначение поля ввода. Отображается, когда свойство РезультатПроверкиДанных принимает значение РезультатПроверкиДанных.Отсутствует

СообщениеОшибка

Текст сообщения об ошибке заполнения данного поля ввода. Отображается, только если свойство РезультатПроверкиДанных принимает значение РезультатПроверкиДанных.Ошибка

СообщениеУспех

Текст сообщения об успешном заполнении данного поля ввода. Отображается, только если свойство РезультатПроверкиДанных принимает значение РезультатПроверкиДанных.Успех

СообщениеПредупреждение

Текст с предупреждением для данного поля ввода. Отображается, только если свойство РезультатПроверкиДанных принимает значение РезультатПроверкиДанных.Предупреждение

СписокВыбора

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

СправочнаяПодсказка

Используется только в веб-интерфейсе. Напротив заголовка поля ввода будет показана иконка с вопросом. Нажатие на иконку открывает подсказку с данной строкой

ТекстРедактирования

Текущий текст редактирования. Обновляется через 200 мс после окончания ввода текста пользователем

События

ПриАвтоПодборе

вызывает это событие:

Во время ввода текста, с некоторым интервалом. Значение Событие.Текст может быть пустым, если пользователь стер текст в поле ввода;
При нажатии клавиши «Стрелка вниз», кнопки открытия списка выбора или при активизации поля ввода мышью. Значение Событие.Текст может быть пустым, если событие вызывается, когда пользователь еще не начал редактировать текст в поле. Если пользователь находится в процессе редактирования текста, в событии находится этот редактируемый текст.

В этом событии вы можете сформировать собственный список подобранных значений и поместить его в Событие.ЗначенияАвтоПодбора

Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: d0d52e24-3a69-4d1d-8f27-cefcf359c116
Имя: МоеПолеВвода
Наследует:
    Тип: ПолеВвода<Строка>
    ПриАвтоПодборе: ОбработчикПриАвтоПодборе

Сигнатура обработчика события на встроенном языке:

метод ОбработчикПриАвтоПодборе(Источник: ПолеВвода<Строка>, Событие: СобытиеПриАвтоПодборе)
;

ПриИзменении

вызывает это событие после установки нового значения в свойство Значение

Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: d0d52e24-3a69-4d1d-8f27-cefcf359c116
Имя: МоеПолеВвода
Наследует:
    Тип: ПолеВвода<Строка>
    ПриИзменении: ОбработчикПриИзменении

Сигнатура обработчика события на встроенном языке:

метод ОбработчикПриИзменении(Источник: ПолеВвода<Строка>, Событие: СобытиеПриИзменении<неизвестно>)
;

ПриНажатииВвода

вызывает это событие при нажатии пользователем клавиши Ввод. Перед вызовом события введенные данные записываются в поле данных, связанное со свойством Значение. Если запись данных невозможна по причине их некорректности (например, несоответствия маске или доступному значению из списка), то запись не происходит и событие не вызывается.

Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: d0d52e24-3a69-4d1d-8f27-cefcf359c116
Имя: МоеПолеВвода
Наследует:
    Тип: ПолеВвода<Строка>
    ПриНажатииВвода: ОбработчикПриНажатииВвода

Сигнатура обработчика события на встроенном языке:

метод ОбработчикПриНажатииВвода(Источник: ПолеВвода<Строка>, Событие: СобытиеКомпонента)
;