MonthCalendar

Описание

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

Комментарии

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

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

Пример

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

В компоненте есть возможность выбора режима отображения календаря с помощью кнопок «Дни», «Недели», «Месяцы», «Кварталы», «Полугодия», расположенных в верхней части календаря.

Под кнопками выбора режима отображения календаря расположены кнопки перехода к следующему/предыдущему периоду. Кнопки перехода к следующему/предыдущему году доступны во всех режимах, кроме режима месяцев. В режиме месяцев доступны кнопки перехода к следующему/предыдущему полугодию. Кнопки перехода к следующему/предыдущему месяцу доступны режиме дней. При наведении курсора на эти кнопки отображаются установленные в свойствах PreviousHalfYearName, PreviousMonthName, PreviousYearName, NextHalfYearName, NextMonthName и MonthCalendar.NextYearName всплывающие подсказки.

Дата выбирается из календаря в подходящем для пользователя режиме.

Время устанавливается в полях ввода с кнопками прокрутки «Часы» и «Минуты». Значение минут и часов может быть введено с клавиатуры или выбрано с помощью кнопок прокрутки или клавиш «Вверх/Вниз» (курсор должен быть установлен в поле ввода).

Текущие дату и время можно установить нажатием на кнопку «Сегодня».

Пример создания компонента MonthCalendar.

Конструкторы

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

Свойства

  Имя свойства Краткое описание
CurrentDate Свойство CurrentDate устанавливает дату в календаре.
MaxDate Свойство MaxDate устанавливает максимальное допустимое значение даты в календаре.
MinDate Свойство MinDate устанавливает минимальное допустимое значение даты для календаря.
Mode Свойство Mode устанавливает режим отображения календаря.
NextHalfYearName Свойство NextHalfYearName устанавливает текст всплывающей подсказки для кнопки «Следующие полгода» в режиме недель.
NextMonthName Свойство NextMonthName устанавливает текст всплывающей подсказки для кнопки «Следующий месяц».
NextYearName Свойство NextYearName устанавливает текст всплывающей подсказки для кнопки «Следующий год».
PreviousHalfYearName Свойство PreviousHalfYearName устанавливает текст всплывающей подсказки для кнопки «Предыдущие полгода» в режиме недель.
PreviousMonthName Свойство PreviousMonthName устанавливает текст всплывающей подсказки для кнопки «Предыдущий месяц».
PreviousYearName Свойство PreviousYearName устанавливает текст всплывающей подсказки для кнопки «Предыдущий год».
ShowDaysButton Свойство ShowDaysButton устанавливает видимость кнопки «Дни».
ShowHalfYearsButton Свойство ShowHalfYearsButton устанавливает видимость кнопки «Полугодия».
ShowNowButton Свойство ShowNowButton устанавливает видимость кнопки «Сегодня».
ShowMonthsButton Свойство ShowMonthsButton устанавливает видимость кнопки «Месяцы».
ShowQuartersButton Свойство ShowQuartersButton устанавливает видимость кнопки «Кварталы».
ShowTime Свойство ShowTime устанавливает видимость элементов для ввода времени.
ShowWeeksButton Свойство ShowWeeksButton устанавливает видимость кнопки «Недели».

Методы

  Имя метода Краткое описание
getCurrentDay Метод getCurrentDay возвращает значение дня.
getCurrentHalfYear Метод getCurrentHalfYear возвращает значение полугодия.
getCurrentHour Метод getCurrentHour возвращает значение часа.
getCurrentMinute Метод getCurrentMinute возвращает значение минуты.
getCurrentMonth Метод getCurrentMonth возвращает значение месяца.
getCurrentQuarter Метод getCurrentQuarter возвращает значение квартала.
getCurrentWeek Метод getCurrentWeek возвращает значение недели.
getCurrentYear Метод getCurrentYear возвращает значение года.

События

   Имя события Краткое описание
AfterModeChanged Событие AfterModeChanged наступает после смены режима отображения календаря и установки размеров.
AfterRender Событие AfterRender наступает при отрисовке компонента.
Change Событие Change при изменении даты.
ClickNow Событие ClickNow наступает при нажатии на кнопку «Сегодня».
CurrentDateChanged Событие CurrentDateChanged наступает при смене текущей даты с помощью свойства CurrentDate.
MaxDateChanged Событие MaxDateChanged наступает при смене или установке максимального значения даты при помощи свойства MaxDate.
MinDateChanged Событие MinDateChanged наступает при смене или установке минимального значения даты при помощи свойства MinDate.
ModeChanged Событие ModeChanged наступает при смене режима отображения календаря.
SelectDay Событие SelectDay наступает при выборе дня в календаре.
SelectHalfYear Событие SelectHalfYear наступает при выборе полугодия в календаре.
SelectMonth Событие SelectMonth наступает при выборе месяца в календаре.
SelectQuarter Событие SelectQuarter наступает пр выборе квартала в календаре.
SelectWeek Событие SelectWeek наступает при выборе недели в календаре.
ShowDaysButtonChanged Событие ShowDaysButtonChanged наступает при изменении значения свойства MonthCalendar.ShowDaysButton.
ShowHalfYearsButtonChanged Событие ShowHalfYearsButtonChanged наступает при изменении значения свойства MonthCalendar.ShowHalfYearsButton.
ShowMonthsButtonChanged Событие ShowMonthsButtonChanged наступает при изменении значения свойства MonthCalendar.ShowMonthsButton.
ShowNowButtonChanged Событие ShowNowButtonChanged наступает при изменении значения свойства MonthCalendar.ShowNowButton.
ShowQuartersButtonChanged Событие ShowQuartersButtonChanged наступает при изменении значения свойства MonthCalendar.ShowQuartersButton.
ShowTimeChanged Событие ShowTimeChanged наступает при изменении значения свойства MonthCalendar.ShowTime.
ShowWeeksButtonChanged Событие ShowWeeksButtonChanged наступает при изменении значения свойства MonthCalendar.ShowWeeksButton.

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

  Имя метода Краткое описание
getCurrentDay Метод getCurrentDay возвращает значение дня.
getCurrentHalfYear Метод getCurrentHalfYear возвращает значение полугодия.
getCurrentHour Метод getCurrentHour возвращает значение часа.
getCurrentMinute Метод getCurrentMinute возвращает значение минуты.
getCurrentMonth Метод getCurrentMonth возвращает значение месяца.
getCurrentQuarter Метод getCurrentQuarter возвращает значение квартала.
getCurrentWeek Метод getCurrentWeek возвращает значение недели.
getCurrentYear Метод getCurrentYear возвращает значение года.

Свойства, унаследованные от класса 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-компоненты