Элемент управления "Календарь месяца"

В этом разделе содержатся сведения о элементах программирования, используемых с элементами управления календарем месяца.

Общие сведения

Раздел	Содержимое
Элементы управления календарем месяца	Элемент управления календарем месяца реализует пользовательский интерфейс, подобный календарю.
Использование элементов управления календарем месяца	В этом разделе содержатся сведения о элементах управления календарем месяца программирования.

Макросы

Раздел	Содержимое
MonthCal_GetCalendarBorder	Возвращает размер границы (в пикселях) элемента управления календаря месяца. Этот макрос можно использовать или явно отправить сообщение MCM_GETCALENDARBORDER.
MonthCal_GetCalendarCount	Возвращает количество календарей, отображаемых в элементе управления календарем. Этот макрос можно использовать или явно отправить сообщение MCM_GETCALENDARCOUNT.
MonthCal_GetCalendarGridInfo	Возвращает сведения о сетке календаря.
MonthCal_GetCALID	Возвращает текущий идентификатор календаря для заданного элемента управления календарем. Этот макрос можно использовать или явно отправить сообщение MCM_GETCALID.
MonthCal_GetColor	Извлекает цвет для заданной части элемента управления календаря месяца. Этот макрос можно использовать или явно отправить сообщение MCM_GETCOLOR.
MonthCal_GetCurrentView	Возвращает представление элемента управления календаря месяца. Этот макрос можно использовать или явно отправить сообщение MCM_GETCURRENTVIEW.
MonthCal_GetCurSel	Извлекает выбранную в данный момент дату. Этот макрос можно использовать или явно отправить сообщение MCM_GETCURSEL.
MonthCal_GetFirstDayOfWeek	Получает первый день недели для элемента управления календарем месяца. Этот макрос можно использовать или явно отправить сообщение MCM_GETFIRSTDAYOFWEEK.
MonthCal_GetMaxSelCount	Извлекает максимальный диапазон дат, который можно выбрать в элементе управления календарем месяца. Этот макрос можно использовать или явно отправить сообщение MCM_GETMAXSELCOUNT.
MonthCal_GetMaxTodayWidth	Извлекает максимальную ширину строки "сегодня" в элементе управления календаря месяца. К ним относятся текст метки и текст даты. Этот макрос можно использовать или явно отправить сообщение MCM_GETMAXTODAYWIDTH.
MonthCal_GetMinReqRect	Извлекает минимальный размер, необходимый для отображения полного месяца в элементе управления календарем месяца. Сведения о размере представлены в виде структуры RECT . Этот макрос можно использовать или явно отправить сообщение MCM_GETMINREQRECT.
MonthCal_GetMonthDelta	Извлекает частоту прокрутки для элемента управления календаря месяца. Скорость прокрутки — это количество месяцев, которое элемент управления перемещает его отображение, когда пользователь нажимает кнопку прокрутки. Этот макрос можно использовать или явно отправить сообщение MCM_GETMONTHDELTA.
MonthCal_GetMonthRange	Извлекает сведения о дате (с помощью структур SYSTEMTIME ), представляющих высокие и низкие ограничения отображения элемента управления календарем месяца. Этот макрос можно использовать или явно отправить сообщение MCM_GETMONTHRANGE.
MonthCal_GetRange	Извлекает минимальные и максимальные допустимые даты для элемента управления календарем месяца. Этот макрос можно использовать или явно отправить сообщение MCM_GETRANGE.
MonthCal_GetSelRange	Извлекает сведения о дате, представляющие верхние и нижние пределы диапазона дат, выбранного пользователем. Этот макрос можно использовать или явно отправить сообщение MCM_GETSELRANGE.
MonthCal_GetToday	Извлекает сведения о дате, указанной как "сегодня" для элемента управления календарем месяца. Этот макрос можно использовать или явно отправить сообщение MCM_GETTODAY.
MonthCal_GetUnicodeFormat	Извлекает флаг формата символов Юникода для элемента управления. Этот макрос можно использовать или явно отправить сообщение MCM_GETUNICODEFORMAT.
MonthCal_HitTest	Определяет, какая часть элемента управления календаря месяца находится в заданной точке на экране. Этот макрос можно использовать или явно отправить сообщение MCM_HITTEST.
MonthCal_SetCalendarBorder	Задает размер границы (в пикселях) элемента управления календаря месяца. Этот макрос можно использовать или явно отправить сообщение MCM_SETCALENDARBORDER.
MonthCal_SetCALID	Задает идентификатор календаря для заданного элемента управления календарем. Этот макрос можно использовать или явно отправить сообщение MCM_SETCALID.
MonthCal_SetColor	Задает цвет для заданной части элемента управления календаря месяца. Этот макрос можно использовать или явно отправить сообщение MCM_SETCOLOR.
MonthCal_SetCurrentView	Задает представление для элемента управления календарем месяца. Этот макрос можно использовать или явно отправить сообщение MCM_SETCURRENTVIEW.
MonthCal_SetCurSel	Задает выбранную дату для элемента управления календарем месяца. Если указанная дата не находится в представлении, элемент управления обновляет отображение, чтобы открыть его в представление. Этот макрос можно использовать или явно отправить сообщение MCM_SETCURSEL.
MonthCal_SetDayState	Задает состояния дня для всех месяцев, которые в настоящее время отображаются в элементе управления календарем месяца. Этот макрос можно использовать или явно отправить сообщение MCM_SETDAYSTATE.
MonthCal_SetFirstDayOfWeek	Задает первый день недели для элемента управления календарем месяца. Этот макрос можно использовать или явно отправить сообщение MCM_SETFIRSTDAYOFWEEK.
MonthCal_SetMaxSelCount	Задает максимальное количество дней, которые можно выбрать в элементе управления календарем месяца. Этот макрос можно использовать или явно отправить сообщение MCM_SETMAXSELCOUNT.
MonthCal_SetMonthDelta	Задает частоту прокрутки для элемента управления календарем месяца. Скорость прокрутки — это количество месяцев, которое элемент управления перемещает его отображение, когда пользователь нажимает кнопку прокрутки. Этот макрос можно использовать или явно отправить сообщение MCM_SETMONTHDELTA.
MonthCal_SetRange	Задает минимальные и максимальные допустимые даты для элемента управления календарем месяца. Этот макрос можно использовать или явно отправить сообщение MCM_SETRANGE.
MonthCal_SetSelRange	Задает для элемента управления календаря месяца заданный диапазон дат. Этот макрос можно использовать или явно отправить сообщение MCM_SETSELRANGE.
MonthCal_SetToday	Задает выбор "сегодня" для элемента управления календарем месяца. Этот макрос можно использовать или явно отправить сообщение MCM_SETTODAY.
MonthCal_SetUnicodeFormat	Задает флаг формата символов Юникода для элемента управления. Это сообщение позволяет изменить набор символов, используемый элементом управления во время выполнения, а не повторно создать элемент управления. Этот макрос можно использовать или явно отправлять сообщение MCM_SETUNICODEFORMAT.
MonthCal_SizeRectToMin	Вычисляет, сколько календарей будет соответствовать заданному прямоугольнику, а затем возвращает минимальный размер прямоугольника, который должен соответствовать указанному числу календарей. Этот макрос можно использовать или явно отправить сообщение MCM_SIZERECTTOMIN.

Сообщения

Раздел	Содержимое
MCM_GETCALENDARBORDER	Возвращает размер границы в пикселях. Это сообщение можно отправить явно или с помощью макроса MonthCal_GetCurrentView.
MCM_GETCALENDARCOUNT	Возвращает количество календарей, отображаемых в элементе управления календарем. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_GetCalendarCount.
MCM_GETCALENDARGRIDINFO	Возвращает сведения о сетке календаря.
MCM_GETCALID	Возвращает идентификатор календаря для заданного элемента управления календарем. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_GetCALID.
MCM_GETCOLOR	Извлекает цвет для заданной части элемента управления календаря месяца. Это сообщение можно отправить явным образом или с помощью макроса MonthCal_GetColor.
MCM_GETCURRENTVIEW	Возвращает текущее представление календаря. Это сообщение можно отправить явно или с помощью макроса MonthCal_GetCurrentView.
MCM_GETCURSEL	Извлекает выбранную в данный момент дату. Это сообщение можно отправить явным образом или с помощью макроса MonthCal_GetCurSel.
MCM_GETFIRSTDAYOFWEEK	Получает первый день недели для элемента управления календарем месяца. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_GetFirstDayOfWeek.
MCM_GETMAXSELCOUNT	Извлекает максимальный диапазон дат, который можно выбрать в элементе управления календарем месяца. Это сообщение можно отправить явно или с помощью макроса MonthCal_GetMaxSelCount.
MCM_GETMAXTODAYWIDTH	Извлекает максимальную ширину строки "сегодня" в элементе управления календаря месяца. К ним относятся текст метки и текст даты. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_GetMaxTodayWidth.
MCM_GETMINREQRECT	Извлекает минимальный размер, необходимый для отображения полного месяца в элементе управления календарем месяца. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_GetMinReqRect.
MCM_GETMONTHDELTA	Извлекает частоту прокрутки для элемента управления календаря месяца. Скорость прокрутки — это количество месяцев, которое элемент управления перемещает его отображение, когда пользователь нажимает кнопку прокрутки. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_GetMonthDelta.
MCM_GETMONTHRANGE	Извлекает сведения о дате (с помощью структур SYSTEMTIME ), представляющих высокие и низкие ограничения отображения элемента управления календарем месяца. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_GetMonthRange.
MCM_GETRANGE	Извлекает минимальные и максимальные допустимые даты для элемента управления календарем месяца. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_GetRange.
MCM_GETSELRANGE	Извлекает сведения о дате, представляющие верхние и нижние пределы диапазона дат, выбранного пользователем. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_GetSelRange.
MCM_GETTODAY	Извлекает сведения о дате, указанной как "сегодня" для элемента управления календарем месяца. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_GetToday.
MCM_GETUNICODEFORMAT	Извлекает флаг формата символов Юникода для элемента управления. Это сообщение можно отправить явно или использовать макрос MonthCal_GetUnicodeFormat.
MCM_HITTEST	Определяет, какая часть элемента управления календаря месяца находится в заданной точке на экране. Это сообщение можно отправить явно или с помощью макроса MonthCal_HitTest.
MCM_SETCALENDARBORDER	Задает размер границы в пикселях. Это сообщение можно отправить явно или с помощью макроса MonthCal_SetCurrentView.
MCM_SETCALID	Задает идентификатор календаря для заданного элемента управления календарем. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_SetCALID.
MCM_SETCOLOR	Задает цвет для заданной части элемента управления календаря месяца. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_SetColor.
MCM_SETCURRENTVIEW	Задает текущее представление календаря. Это сообщение можно отправить явно или с помощью макроса MonthCal_SetCurrentView.
MCM_SETCURSEL	Задает выбранную дату для элемента управления календарем месяца. Если указанная дата не находится в представлении, элемент управления обновляет отображение, чтобы открыть его в представление. Это сообщение можно отправить явным образом или с помощью макроса MonthCal_SetCurSel.
MCM_SETDAYSTATE	Задает состояния дня для всех месяцев, которые в настоящее время отображаются в элементе управления календарем месяца. Это сообщение можно отправить явно или с помощью макроса MonthCal_SetDayState.
MCM_SETFIRSTDAYOFWEEK	Задает первый день недели для элемента управления календарем месяца. Это сообщение можно отправить явным образом или с помощью макроса MonthCal_SetFirstDayOfWeek.
MCM_SETMAXSELCOUNT	Задает максимальное количество дней, которые можно выбрать в элементе управления календарем месяца. Это сообщение можно отправить явно или с помощью макроса MonthCal_SetMaxSelCount.
MCM_SETMONTHDELTA	Задает частоту прокрутки для элемента управления календарем месяца. Скорость прокрутки — это количество месяцев, которое элемент управления перемещает его отображение, когда пользователь нажимает кнопку прокрутки. Это сообщение можно отправить явным образом или с помощью макроса MonthCal_SetMonthDelta.
MCM_SETRANGE	Задает минимальные и максимальные допустимые даты для элемента управления календарем месяца. Это сообщение можно отправить явным образом или с помощью макроса MonthCal_SetRange.
MCM_SETSELRANGE	Задает для элемента управления календаря месяца заданный диапазон дат. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_SetSelRange.
MCM_SETTODAY	Задает выбор "сегодня" для элемента управления календарем месяца. Это сообщение можно отправить явно или с помощью макроса MonthCal_SetToday.
MCM_SETUNICODEFORMAT	Задает флаг формата символов Юникода для элемента управления. Это сообщение позволяет изменить набор символов, используемый элементом управления во время выполнения, а не повторно создать элемент управления. Это сообщение можно отправить явно или использовать макрос MonthCal_SetUnicodeFormat.
MCM_SIZERECTTOMIN	Вычисляет, сколько календарей будет соответствовать заданному прямоугольнику, а затем возвращает минимальный размер прямоугольника, который должен соответствовать указанному числу календарей. Это сообщение можно отправлять явным образом или с помощью макроса MonthCal_SizeRectToMin.

Notifications

Раздел	Содержимое
MCN_GETDAYSTATE	Отправляемый элементом управления календаря месяца, чтобы запросить сведения о том, как должны отображаться отдельные дни. Этот код уведомления отправляется только элементами управления календарем месяца, которые используют стиль MCS_DAYSTATE и отправляются в виде сообщения WM_NOTIFY.
MCN_SELCHANGE	Отправляется элементом управления календарем месяца при изменении выбранной даты или диапазона дат. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
MCN_SELECT	Отправляется элементом управления календарем месяца, когда пользователь делает явный выбор даты в течение месяца. Это уведомление отправляется в виде сообщения WM_NOTIFY.
MCN_VIEWCHANGE	Отправляется элементом управления календарем месяца при изменении текущего представления. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
NM_RELEASEDCAPTURE (monthcal)	Уведомляет родительское окно элемента управления monthcal о том, что элемент управления освобождает запись мыши. Это уведомление отправляется в виде сообщения WM_NOTIFY.

Структуры

Раздел	Содержимое
MCGRIDINFO	Содержит сведения о части элемента управления календарем.
MCHITTESTINFO	Содержит сведения, относящиеся к точкам тестирования попаданий для элемента управления календарем месяца. Эта структура используется с сообщением MCM_HITTEST и соответствующим макросом MonthCal_HitTest.
NMDAYSTATE	Содержит сведения, необходимые для обработки кода уведомлений MCN_GETDAYSTATE . Все члены этой структуры предназначены для входных данных, кроме prgDayState, которые принимающее приложение должно задать при обработке MCN_GETDAYSTATE.
NMSELCHANGE	Содержит сведения, необходимые для обработки кода уведомления MCN_SELCHANGE .
NMVIEWCHANGE	Хранит сведения, необходимые для обработки кода уведомления MCN_VIEWCHANGE .

Константы

Раздел	Содержимое
Стили элементов управления "Календарь месяца"	При создании элементов управления календарем месяца используются следующие константы стиля.

Типы данных

Раздел	Содержимое
MONTHDAYSTATE	Тип данных MONTHDAYSTATE — это битовое поле, которое содержит состояние каждого дня в месяц.