Компонент 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. |
| Имя метода | Краткое описание | |
| getCurrentDay | Метод getCurrentDay возвращает значение дня. | |
| getCurrentHalfYear | Метод getCurrentHalfYear возвращает значение полугодия. | |
| getCurrentHour | Метод getCurrentHour возвращает значение часа. | |
| getCurrentMinute | Метод getCurrentMinute возвращает значение минуты. | |
| getCurrentMonth | Метод getCurrentMonth возвращает значение месяца. | |
| getCurrentQuarter | Метод getCurrentQuarter возвращает значение квартала. | |
| getCurrentWeek | Метод getCurrentWeek возвращает значение недели. | |
| getCurrentYear | Метод getCurrentYear возвращает значение года. |
| Имя свойства | Краткое описание | |
| Свойство 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 устанавливает ширину компонента. |
| Имя метода | Краткое описание | |
| Метод 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 обновляет размеры компонента подгонке размеров контейнера, в котором находится компонент. |
| Имя события | Краткое описание | |
| Событие Drag наступает при нажатии и удерживании клавиши мыши. | ||
| Событие DragEnd наступает при окончании перетаскивания компонента. | ||
| Событие DragStart наступает, когда начинается перетаскивание компонента. | ||
| Событие OnContextMenu наступает при вызове контекстного меню компонента. | ||
| Событие SizeChanged наступает после изменения размеров компонента. | ||
| Событие SizeChanging наступает во время изменения размеров компонента. |
| Имя свойства | Краткое описание | |
| Свойство Data ассоциирует произвольный объект с данным компонентом. | ||
| Свойство Id устанавливает идентификатор компонента. | ||
| Свойство Settings задает параметры компонента. |
| Имя метода | Краткое описание | |
| Метод clone создает копию объекта. Не реализован в PP.Ui.Control. | ||
| Метод dispose уничтожает компонент. | ||
| Метод getTypeName возвращает имя типа объекта без пространства имён, к которому он принадлежит. |
См. также: