DateTimePicker

Описание

Компонент DateTimePicker представляет собой редактор для ввода даты и времени с календарем для выбора даты.

Комментарии

Компонент реализован классом DateTimePicker.

Компонент DateTimePicker совмещает компоненты DateTimeEdit и MonthCalendar.

Компонент работает с локальным временем, поправки на часовой пояс нужно производить самостоятельно.

Пример

Компонент имеет следующий вид:

При нажатии на кнопку вызова календаря раскрывается календарь, реализованный компонентом MonthCalendar:

Выбранное из календаря значение даты устанавливается в поле ввода, реализованном компонентом DateTimeEdit.

Также дата может быть введена с клавиатуры или изменена с помощью клавиш «Вверх/Вниз». При изменении даты в редакторе будет изменена отметка в календаре.

Конструктор

  Имя конструктора Краткое описание
DateTimePicker Конструктор DateTimePicker создает экземпляр компонента DateTimePicker.

Свойства

  Имя свойства Краткое описание
CurrentDate Свойство CurrentDate устанавливает дату и время для компонента.
DropHeight Свойство DropHeight устанавливает высоту области, на которой расположена раскрывающаяся панель.
DropWidth Свойство DropWidth устанавливает ширину области, на которой расположена раскрывающаяся панель.
MaxDate Свойство MaxDate устанавливает максимальное возможное значение даты и времени.
MinDate Свойство MinDate устанавливает минимальное допустимое значение даты для компонента.
Mode Свойство Mode возвращает режим отображения календаря и поля ввода компонента.
MonthNames Свойство MonthNames задаёт массив с наименованиями месяцев, которые отображаются в поле ввода редактора в режиме месяцев.
NextMonthName Свойство NextMonthName устанавливает текст всплывающей подсказки для кнопки «Следующий месяц».
NextYearName Свойство NextYearName устанавливает текст всплывающей подсказки для кнопки «Следующий год».
PreviousMonthName Свойство PreviousMonthName устанавливает текст всплывающей подсказки для кнопки «Предыдущий месяц».
PreviousYearName Свойство PreviousYearName устанавливает текст всплывающей подсказки для кнопки «Предыдущий год».
ShowTime Свойство ShowTime определяет, отображается ли время в компоненте.
TextAfterHalfYear Свойство TextAfterHalfYear устанавливает текст, который будет отображён в поле ввода после значения полугодия.
TextAfterMonth Свойство TextAfterMonth устанавливает текст, который будет отображён в поле ввода после значения месяца.
TextAfterQuarter Свойство TextAfterQuarter устанавливает текст, который будет отображён в поле ввода после значения квартала.
TextAfterWeek Свойство TextAfterWeek устанавливает текст, который будет отображён в поле ввода после значения недели.
TextAfterYear Свойство TextAfterYear устанавливает текст, который будет отображён в поле ввода после значения года.

Методы

  Имя метода Краткое описание
getCalendar Метод getCalendar возвращает календарь.
getDateTimeEdit Метод getDateTimeEdit возвращает компонент для ввода даты и времени.

События

  Имя события Краткое описание
DateTimeChange Событие DateTimeChange наступает при изменении даты.
SelectDay Событие SelectDay наступает при выборе дня в календаре.
TextChange Событие TextChange наступает при изменении значения в поле ввода.

Свойства, унаследованные от класса Combo

  Имя свойства Краткое описание
CloseOnContentClick Свойство CloseOnContentClick определяет возможность закрытия панели компонента по нажатию на заголовок.
EnableEdit Свойство EnableEdit устанавливает возможность ввода.
IsDropHasCombosWidth Свойство IsDropHasCombosWidth устанавливает признак независимости ширины раскрывающейся панели от ширины редактора ввода.
IsHint Свойство IsHint определяет отображение подсказки при наведении курсора мыши на кнопку открытия раскрывающейся панели.
NoCreateEditors Свойство NoCreateEditors определяет признак того, что заголовок отобразится простым текстом, а не в редакторах компонентов TextBox или MaskEdit.
OpenOnContentClick Свойство OpenOnContentClick определяет возможность раскрытия панели компонента по нажатию на заголовок.
OpenOnIconClick Свойство OpenOnIconClick определяет возможность раскрытия панели компонента по нажатию на пиктограмму заголовка.
OpenOnKeyDown Свойство OpenOnKeyDown определяет возможность открытия всплывающей панели по нажатию кнопки клавиатуры.
UseMask Свойство UseMask устанавливает возможность использования редактора маски.

Методы, унаследованные от класса Combo

  Имя метода Краткое описание
applyNotValidCSS Метод applyNotValidCSS устанавливает стиль, определяющий подсветку некорректно введенного значения редактора ввода.
applyValidCSS Метод applyValidCSS устанавливает стиль, определяющий подсветку корректно введенного значения редактора ввода.
getContentNode Метод getContentNode возвращает DOM-узел компонента редактора ввода.
getDropPanel Метод getDropPanel возвращает раскрывающуюся часть компонента.
getIconHeight Метод getIconHeight возвращает значение высоты пиктограммы редактора ввода.
getIconWidth Метод getIconeWidth возвращает значение ширины пиктограммы редактора ввода.
getMaskEdit Метод getMaskEdit возвращает редактор ввода данных, соответствующих определенному шаблону.
getTextBox Метод getTextBox возвращает текстовое поле редактора ввода.
setIconImageClass Метод setIconImageClass меняет имя класса компонента пиктограммы редактора ввода.
showDropPanel Метод showDropPanel отображает раскрывающуюся часть компонента.

События, унаследованные от класса Combo

   Имя события Краткое описание
TextChanged Событие TextChanged наступает при изменении текста в редакторе.
ValueChanged Событие ValueChanged наступает после изменения содержимого редактора ввода.

Свойства, унаследованные от класса Control

  Имя свойства Краткое описание
Свойство Anchors определяет позицию компонента, размещенного внутри контейнера.
Свойство Animation устанавливает параметры анимации для компонента.
Bottom Свойство Bottom устанавливает отступ снизу при размещении компонента внутри LayoutPanel.
Свойство Content устанавливает содержимое компонента.
Свойство ContextMenu устанавливает контекстное меню для компонента.
Свойство Data предназначено для хранения любых пользовательских данных.
DataContext Свойство DataContext содержит объект с данными.
Свойство Enabled устанавливает, является ли компонент доступным для использования.
Свойство Height устанавливает высоту компонента.
Свойство IsResizable определяет, можно ли изменять размеры компонента.
Свойство IsRTL устанавливает направление текста справа налево.
Свойство IsVisible определяет, отображается ли компонент.
Свойство Left устанавливает отступ слева при размещении компонента внутри GridPanel.
Свойство Offset определяет координаты корневой DOM-вершины элемента управления.
Свойство Opacity определяет прозрачность компонента.
Свойство Parent определяет родительский компонент элемента управления.
Свойство ParentNode устанавливает родительскую DOM-вершину.
Свойство ResourceKey устанавливает ресурсный ключ для компонента.
Right Свойство Right устанавливает отступ справа при размещении компонента внутри LayoutPanel.
Свойство Rotate устанавливает угол поворота компонента.
Свойство ShowToolTip определяет, включена ли возможность отображать всплывающую подсказку компонента.
Свойство Style устанавливает стиль для компонента.
Свойство TabIndex задает последовательность перехода элемента управления внутри контейнера.
Свойство Tag устанавливает JSON-объект, ассоциированный с компонентом.
Свойство ToolTip определяет текст всплывающей подсказки компонента.
Свойство Top устанавливает отступ сверху при размещении компонента внутри GridPanel.
Свойство Value задает значение компоненту.
Свойство Width устанавливает ширину компонента.

Методы, унаследованные от класса Control

  Имя метода Краткое описание
Метод addClass добавляет CSS-класс к компоненту.
addEvent Метод addEvent добавляет обработчик события на DOM-вершину.
addEventHandler Метод addEventHandler добавляет обработчик события на DOM-вершину.
addEvents Метод addEvents добавляет массив обработчиков событий на DOM-вершину.
Метод addStateClass добавляет CSS-класс к компоненту и удаляет прежний CSS-класс.
addStyleBySelector Метод addStyleBySelector создает блок со стилем с указанным css-селектором.
Метод addToNode добавляет компонент в указанную вершину.
bindEvents Метод bindEvents подписывает элемент на все стандартные события.
Метод clearStylesCache очищает кэш стилей компонента.
Метод getAnchorFlags возвращает JSON-объект с настройками текущей позиции компонента.
Метод getClass возвращает текущие css-классы компонента.
Метод getCssStyle возвращает стили для указанной вершины.
Метод getDomNode возвращает главную DOM-вершину компонента.
Метод getFocused определяет наличие фокуса у компонента.
getFunctionByName Метод getFunctionByName возвращает функцию по имени.
getIsBinded Метод getIsBinded возвращает признак подписи элемента на события DOM-вершины.
Метод hasClass определяет, задан ли для корневой DOM-вершины элемента управления указанный CSS-класс.
Метод hide скрывает элемент управления.
Метод hideToolTip очищает таймаут появления подсказки и скрывает ее, если она был показана.
Метод isResingNow определяет, изменяются ли в данный момент размеры компонента.
refreshBindingProperty Метод refreshBindingProperty обновляет привязанное свойство по имени.
refreshItemsStyle Метод refreshItemsStyle обновляет CSS-стили дочерних элементов.
refreshStyle Метод refreshStyle обновляет CSS-стили элемента.
Метод removeClass удаляет CSS-класс из компонента.
Метод removeEvent удаляет обработчик события у DOM-вершины.
removeEventHandler Метод removeEventHandler удаляет обработчик события DOM-вершины.
removeFromDOM Метод removeFromDOM удаляет вершину из DOM-структуры.
Метод removeStateClasses удаляет CSS-классы компонента.
Метод setDraggable устанавливает возможность перетаскивания компонента на html-странице.
Метод setFocus устанавливает фокус компонента.
Метод setIsHovered отображает компонент как при наведении на него курсора.
Метод setIsPressed отображает компонент как при клике по нему.
Метод setOpacityIE8 устанавливает значение прозрачности компонента в браузере InternetExplorer 8.
Метод setSize устанавливает размеры компонента.
Метод show отображает элемент управления.
unBindEvents Метод unBindEvents отписывает элемент от всех стандартных событий.
Метод updatePosition корректирует размер и положение при абсолютном позиционировании на основе текущих параметров.
Метод updateSize обновляет размеры компонента подгонке размеров контейнера, в котором находится компонент.

События, унаследованные от класса Control

  Имя события Краткое описание
Событие Drag наступает при нажатии и удерживании клавиши мыши.
Событие DragEnd наступает при окончании перетаскивания компонента.
Событие DragStart наступает, когда начинается перетаскивание компонента.
Событие OnContextMenu наступает при вызове контекстного меню компонента.
Событие SizeChanged наступает после изменения размеров компонента.
Событие SizeChanging наступает во время изменения размеров компонента.

Свойства, унаследованные от класса Object

  Имя свойства Краткое описание
Свойство Data ассоциирует произвольный объект с данным компонентом.
Свойство Id устанавливает идентификатор компонента.
Свойство Settings задает параметры компонента.

Методы, унаследованные от класса Object

  Имя метода Краткое описание
Метод clone создает копию объекта. Не реализован в PP.Ui.Control.
Метод dispose уничтожает компонент.
Метод getTypeName возвращает имя типа объекта без пространства имен, к которому он принадлежит.

См. также:

DHTML-компоненты