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