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

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

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

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

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

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

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

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

	Имя метода	Краткое описание
	clone	Метод clone создает копию объекта.
	dispose	Метод dispose уничтожает компонент.
	getHashCode	Метод getHashCode возвращает хэш-код объекта репозитория.
	getSettings	Метод getSettings возвращает настройки объекта репозитория.
	getTypeName	Метод getTypeName возвращает имя типа объекта без пространства имен, к которому он принадлежит.
	isEqual	Метод isEqual определяет, равен ли заданный объект текущему объекту репозитория.
	isLive	Метод isLive определяет действительность объекта репозитория.
	removeAllEvents	Метод removeAllEvents удаляет все обработчики событий объекта по заданному контексту.
	setSettings	Метод setSettings задает настройки объекта репозитория.
	defineProps	Метод defineProps создает методы get и set из массива имен для указанного класса.
	keys	Метод keys возвращает массив названий методов и свойств для указанного объекта.

См. также:

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