Свойства компонента интерфейса, унаследованного от компонента «ПолеВвода»
Поле для ввода и редактирования данных разных типов.
Иерархия наследования
- Компонент (абстрактный)
Свойства
- ВыравниваниеСодержимогоПоГоризонтали
- Способ выравнивания текста в поле ввода: Начало, Центр, Конец, ПоШирине, Авто — значение Начало.
- ДопустимыеТипы
- Дополнительно ограничивает тип значения поля ввода на этапе исполнения кода.
Используется только тогда, когда тип параметра нельзя задать с помощью обобщенного
типа. Например, если тип задается динамически с помощью вычисляемого
выражения.
Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: ВПодсистеме Ид: d78f5166-ddff-41de-9c84-1f28712dae5c Имя: ФормаОтображенияРезультатаЗапроса Свойства: - Имя: МойРезультатЗапроса Тип: РезультатЗапроса<Объект> Наследует: Тип: Форма Содержимое: Тип: ПолеВвода<Объект?> ДопустимыеТипы: =[МойРезультатЗапроса.Значение.ПолучитьТип()] Значение: =МойРезультатЗапроса.Значение
- ДиапазонВыделения
- Только чтение. Границы выделенного текста
- Заголовок
- Заголовок поля ввода
- Значение
- Значение поля ввода. Изменяется при переходе на другой компонент интерфейса
- Изображение
- Значение типа ДвоичныйОбъект.Ссылка. Ссылка на двоичные данные картинки, которая будет показана в начале поля ввода
- Картинка
- Картинка, которую использует поле ввода
- Коннотация
- Коннотация поля ввода
- НастройкиВводаДатыВремени
- Настройки редактирования даты и времени. Применяется если поле ввода редактирует значения типов Дата, ДатаВремя, Время, Момент
- НастройкиВводаДлительности
- Задает настройки ввода длительности. Применяются, если поле ввода редактирует тип Длительность.
- НастройкиВводаСсылок
- Настройки ввода для отдельных допустимых ссылочных типов
- НастройкиВводаСтроки
- Настройки редактирования значений типа Строка
- Описание
- Используется только в веб-интерфейсе. Напротив заголовка поля ввода будет показана иконка с вопросом. Нажатие на иконку открывает подсказку с данной строкой
- ПодсказкаВвода
- Подсказка, отображается внутри поля ввода
- ПризнакОбязательности
- Признак того, что в поле должно быть введено значение. Выглядит как красная звездочка перед заголовком. Установка этого признака имеет только визуальное значение и не оказывает никакого влияния на функционирование поля ввода
- РежимВыбораИзСписка
- Режим выбора из списка:
- НеИспользовать — список выбора не используется;
- Использовать — можно выбирать значения из списка выбора или вводить любые допустимые значения вручную;
- ТолькоЗначенияИзСписка — можно выбирать из списка или вводить вручную только те значения, которые содержатся в списке выбора.
- РежимПароля
- Признак того, что вводимые символы должны маскироваться символами *
- РезервироватьМестоПодПодсказку
- Указывает — резервировать ли место для сообщений, заданных в свойствах СообщениеОшибка, СообщениеИнформация, СообщениеУспех или СообщениеПредупреждение
- СообщениеИнформация
- Текст описания назначения поля ввода. Отображается когда свойство Коннотация принимает значение Коннотация.Отсутствует
- СообщениеОшибка
- Текст сообщения об ошибке заполнения данного поля ввода. Отображается только если свойство Коннотация принимает значение Коннотация.Отрицательная.
- СообщениеУспех
- Текст сообщения об успешном заполнении данного поля ввода. Отображается только, если свойство Коннотация принимает значение Коннотация.Положительная
- СообщениеПредупреждение
- Текст сообщения предупреждения данного поля ввода. Отображается только, если свойство Коннотация принимает значение Коннотация.Предупреждающая
- СписокВыбора
- Список значений для выбора в поле ввода. Поддерживается режим множественного выбора
- ТекстРедактирования
- Текущий текст редактирования. Обновляется через 200 мс после окончания ввода текста пользователем
События
- ПриАвтоПодборе
-
вызывает это событие:
- Во время ввода текста, с некоторым интервалом. Значение
Событие.Текст
может быть пустым, если пользователь стер текст в поле ввода; - При нажатии клавиши «Стрелка вниз», кнопки открытия списка выбора или при активизации поля ввода мышью. Значение
Событие.Текст
может быть пустым, если событие вызывается, когда пользователь еще не начал редактировать текст в поле. Если пользователь находится в процессе редактирования текста, в событии находится этот редактируемый текст.
- Во время ввода текста, с некоторым интервалом. Значение
- ПриИзменении
-
вызывает это событие после установки нового значения в свойство
ЗначениеПример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: ВПодсистеме Ид: d0d52e24-3a69-4d1d-8f27-cefcf359c116 Имя: МоеПолеВвода Наследует: Тип: ПолеВвода<Строка> ПриИзменении: ОбработчикПриИзменении
Сигнатура обработчика события на встроенном языке:метод ОбработчикПриИзменении(Источник: ПолеВвода<Строка>, Событие: СобытиеПриИзменении<неизвестно>) ;
- ПриНажатииВвода
-
вызывает это событие при нажатии пользователем клавиши Ввод. Перед вызовом
события введенные данные записываются в поле данных, связанное со свойством Значение. Если запись данных невозможна по причине их
некорректности (например, несоответствия маске или доступному значению из списка), то запись не происходит и событие не
вызывается.Пример YAML-файла:
ВидЭлемента: КомпонентИнтерфейса ОбластьВидимости: ВПодсистеме Ид: d0d52e24-3a69-4d1d-8f27-cefcf359c116 Имя: МоеПолеВвода Наследует: Тип: ПолеВвода<Строка> ПриНажатииВвода: ОбработчикПриНажатииВвода
Сигнатура обработчика события на встроенном языке:метод ОбработчикПриНажатииВвода(Источник: ПолеВвода<Строка>, Событие: СобытиеКомпонента) ;