5.5.2.1.42. TimeField
API DOCS

Поле для отображения и ввода времени.

gui timeField

XML-имя компонента: timeField.

Компонент TimeField реализован для блоков Web Client и Desktop Client.

  • Для создания поля времени, связанного с данными, необходимо использовать атрибуты datasource и property:

    <dsContext>
    <datasource id="orderDs" class="com.sample.sales.entity.Order" view="_local"/>
</dsContext>
<layout>
    <timeField datasource="orderDs" property="deliveryTime"/>

    Как видно из примера, в экране описывается источник данных orderDs для некоторой сущности Заказ (Order), имеющей атрибут deliveryTime. В компоненте ввода времени в атрибуте datasource указывается ссылка на источник данных, а в атрибуте property − название атрибута сущности, значение которого должно быть отображено в поле.

    Связанный атрибут сущности должен быть типа java.util.Date или java.sql.Time.

  • Формат отображения времени определяется типом данных time и задается в главном пакете локализованных сообщений в ключе timeFormat.

  • Формат отображения времени можно также задать в атрибуте timeFormat компонента. Это может быть как сама строка формата, так и ключ в пакете сообщений (с префиксом msg://).

  • Независимо от упомянутого выше формата отображением секунд можно управлять с помощью атрибута showSeconds. По умолчанию секунды отображаются, если формат содержит символы ss.

    <timeField datasource="orderDs" property="createTs" showSeconds="true"/>
    gui timeFieldSec
Атрибуты timeField

align - caption - contextHelpText - contextHelpTextHtmlEnabled - editable - enable - datasource - description - height - icon - id - property - required - requiredMessage - showSeconds - stylename - tabIndex - timeFormat - visible - width

Элементы timeField

validator

API

addValueChangeListener - commit - discard - isModified - setContextHelpIconClickHandler