Виджет "Селектор времени"
Виджет "Селектор времени" является инструментом ввода данных, который используется для выбора времени начала и времени окончания и помогает фильтровать запрос. Можно задать в нем автоматическое обновление и использовать событие Updated, чтобы постоянно обновлять данные на веб-странице. Управление позволяет вам переходить на четверть интервала или на полный интервал вперед или назад.
Когда вы изменяете выбор времени, автоматическое обновление отключается и событие Update не инициируется, пока пользователь не нажмет кнопку Обновить сейчас. Это позволяет пользователю изменять одну или обе даты перед обновлением.
Свойства
Дополнительные сведения об общих свойствах виджетов см. в разделе Виджеты. Свойства, которые являются специфичными для виджета "Селектор времени", описаны в следующей таблице.
|
Имя свойства
|
Описание
|
Базовый тип
|
Значение по умолчанию
|
Доступно для привязки? (Д/Н)
|
Доступно для локализации? (Д/Н)
|
||||
|---|---|---|---|---|---|---|---|---|---|
|
CustomClass
|
Определяемый пользователем класс CSS для применения к верхнему разделу виджета. Можно ввести несколько классов, разделенных пробелами.
|
STRING
|
Н/Д
|
Д
|
N
|
||||
|
StartDateTime
|
Исходные дата и время начала для виджета.
|
DATETIME
|
Н/Д
|
Д
|
N
|
||||
|
EndDateTime
|
Исходные дата и время окончания для виджета. Если дата окончания не указана, используются текущие дата и время.
|
DATETIME
|
Н/Д
|
Д
|
N
|
||||
|
Interval
|
Размер начального интервала.
|
NUMBER
|
1
|
Д
|
N
|
||||
|
IntervalType
|
Тип начального интервала ("Часы", "Минуты", "Секунды" или "Сутки").
|
STRING
|
Часы
|
Д
|
N
|
||||
|
UseIntervalAsMax
|
Если начальная или конечная даты заблокированы, то введенные вне интервала даты не рассматриваются.
|
BOOLEAN
|
false
|
N
|
N
|
||||
|
RefreshInterval
|
Если включено AutoRefresh, то интервал в секундах, в течение которого можно выполнить сброс до текущего времени для даты окончания, использует значение интервала для длительности.
|
NUMBER
|
30
|
N
|
N
|
||||
|
AutoRefresh
|
Обновляет виджет через интервал времени, определенный в поле RefreshInterval.
|
BOOLEAN
|
True
|
N
|
N
|
||||
|
DateOrder
|
Позиция года, месяца и дня.
|
STRING
|
год-месяц-день
|
N
|
N
|
||||
|
DateDisplay
|
Длина даты.
|
STRING
|
Сокращенная
|
N
|
N
|
||||
|
DisplaySeconds
|
Отображение времени с секундами.
|
BOOLEAN
|
True
|
N
|
N
|
||||
|
DateDelimiter
|
Символ, разделяющий день, месяц и год.
|
STRING
|
- (дефис)
|
N
|
Д
|
||||
|
DateFormatToken
|
Локализация формата даты. Принимает строку или лексему локализации. Это значение переопределяет свойства DateDelimiter, DateOrder и DateDisplay. Поддерживаемые значения формата:
• mm: номер месяца, дополненный нулем
• m: номер месяца
• M: строка краткого наименования месяца
• MM: длинное наименование месяца
• dd: номер дня месяца, дополненный нулем
• d: номер дня месяца
• yyyy: номер года, представленный 4 цифрами
• yy: номер года, представленный 2 цифрами
Оба эти переноса произойдут при следующем вызове средства выбора даты и времени. Чтобы избежать этого, используйте четырехразрядный формат даты и времени "yyyy", если предполагается делать выбор, выходящий на много лет за пределы диапазона.
|
STRING
|
Н/Д
|
N
|
Д
|
||||
|
TabSequence
|
Порядок обхода вкладок.
|
NUMBER
|
0
|
N
|
N
|
||||
|
Widescreen
|
Изменяет макет для настройки широкого экрана.
|
BOOLEAN
|
True
|
N
|
N
|
||||
|
ShowLockControls
|
Добавляет элементы управления для блокировки дат начала или окончания.
|
BOOLEAN
|
false
|
N
|
N
|
||||
|
Updated
|
Событие. Инициируется, когда пользователь нажимает кнопку "Обновить сейчас" или когда инициирована опция AutoRefresh.
|
Н/Д
|
Н/Д
|
Д
|
N
|
