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

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

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

Свойства

ВыравниваниеСодержимогоПоГоризонтали
Способ выравнивания текста в поле ввода: Начало, Центр, Конец, ПоШирине, Авто — значение Начало.
ДопустимыеТипы
Дополнительно ограничивает тип значения поля ввода на этапе исполнения кода. Используется только тогда, когда тип параметра нельзя задать с помощью обобщенного типа. Например, если тип задается динамически с помощью вычисляемого выражения.

Пример 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
Имя: МоеПолеВвода
Наследует:
    Тип: ПолеВвода<Строка>
    ПриНажатииВвода: ОбработчикПриНажатииВвода
Сигнатура обработчика события на встроенном языке:
метод ОбработчикПриНажатииВвода(Источник: ПолеВвода<Строка>, Событие: СобытиеКомпонента)
;