月历控件

本部分包含有关用于月历控件的编程元素的信息。

概述

主题 目录
关于月历控件 月日历控件实现类似于日历的用户界面。
使用月历控件 本部分提供有关编程月历控件的信息。

主题 目录
MonthCal_GetCalendarBorder 获取月份日历控件的边框大小(以像素为单位)。 可以使用此宏或显式发送 MCM_GETCALENDARBORDER 消息。
MonthCal_GetCalendarCount 获取日历控件中当前显示的日历数。 可以使用此宏或显式发送 MCM_GETCALENDARCOUNT 消息。
MonthCal_GetCalendarGridInfo 获取有关日历网格的信息。
MonthCal_GetCALID 获取给定日历控件的当前日历 ID。 可以使用此宏或显式发送 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 检索月份日历控件指定为“today”的日期的日期信息。 可以使用此宏或显式发送 MCM_GETTODAY 消息。
MonthCal_GetUnicodeFormat 检索控件的 Unicode 字符格式标志。 可以使用此宏或显式发送 MCM_GETUNICODEFORMAT 消息。
MonthCal_HitTest 确定某个月日历控件的哪个部分位于屏幕上的给定点。 可以使用此宏或显式发送 MCM_HITTEST 消息。
MonthCal_SetCalendarBorder 设置月日历控件的边框大小(以像素为单位)。 可以使用此宏或显式发送 MCM_SETCALENDARBORDER 消息。
MonthCal_SetCALID 设置给定日历控件的日历 ID。 可以使用此宏或显式发送 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 设置控件的 Unicode 字符格式标志。 此消息允许在运行时更改控件使用的字符集,而无需重新创建控件。 可以使用此宏或显式发送 MCM_SETUNICODEFORMAT 消息。
MonthCal_SizeRectToMin 计算给定矩形中将容纳多少个日历,然后返回矩形需要容纳该数量的日历所需的最小大小。 可以使用此宏或显式发送 MCM_SIZERECTTOMIN 消息。

消息

主题 目录
MCM_GETCALENDARBORDER 获取边框的大小(以像素为单位)。 可以显式发送此消息,也可以使用 MonthCal_GetCurrentView 宏。
MCM_GETCALENDARCOUNT 获取日历控件中当前显示的日历数。 可以显式发送此消息,也可以使用 MonthCal_GetCalendarCount 宏。
MCM_GETCALENDARGRIDINFO 获取有关日历网格的信息。
MCM_GETCALID 获取给定日历控件的日历 ID。 可以显式发送此消息,也可以使用 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 检索月份日历控件指定为“today”的日期的日期信息。 可以显式发送此消息,也可以使用 MonthCal_GetToday 宏。
MCM_GETUNICODEFORMAT 检索控件的 Unicode 字符格式标志。 可以显式发送此消息或使用 MonthCal_GetUnicodeFormat 宏。
MCM_HITTEST 确定月份日历控件的哪个部分位于屏幕上的给定点。 可以显式发送此消息,也可以使用 MonthCal_HitTest 宏。
MCM_SETCALENDARBORDER 设置边框的大小(以像素为单位)。 可以显式发送此消息,也可以使用 MonthCal_SetCurrentView 宏。
MCM_SETCALID 设置给定日历控件的日历 ID。 可以显式发送此消息,也可以使用 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 设置控件的 Unicode 字符格式标志。 此消息允许你在运行时更改控件使用的字符集,而无需重新创建控件。 可以显式发送此消息或使用 MonthCal_SetUnicodeFormat 宏。
MCM_SIZERECTTOMIN 计算给定矩形中将容纳多少个日历,然后返回矩形所需的最小大小以适应该数量的日历。 可以显式发送此消息,也可以使用 MonthCal_SizeRectToMin 宏发送。

通知

主题 目录
MCN_GETDAYSTATE 按月日历控件发送,请求有关应如何显示单个天数的信息。 此通知代码仅按使用 MCS_DAYSTATE 样式的月历控件发送,并且以 WM_NOTIFY 邮件的形式发送。
MCN_SELCHANGE 当当前所选日期或日期范围发生更改时,按月日历控件发送。 此通知代码以 WM_NOTIFY 消息的形式发送。
MCN_SELECT 当用户在月日历控件中进行显式日期选择时,按月日历控件发送。 此通知以 WM_NOTIFY 消息的形式发送。
MCN_VIEWCHANGE 当当前视图发生更改时,按月日历控件发送。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_RELEASEDCAPTURE (monthcal) 通知月卡控件的父窗口,该控件正在释放鼠标捕获。 此通知以 WM_NOTIFY 消息的形式发送。

结构

主题 目录
MCGRIDINFO 包含有关日历控件的一部分的信息。
MCHITTESTINFO 传递特定于月日历控件命中测试点的信息。 此结构与 MCM_HITTEST 消息和相应的 MonthCal_HitTest 宏一起使用。
NMDAYSTATE 传递处理 MCN_GETDAYSTATE 通知代码所需的信息。 此结构的所有成员均用于输入,但 prgDayState 除外,接收应用程序在处理MCN_GETDAYSTATE时必须设置。
NMSELCHANGE 传递处理 MCN_SELCHANGE 通知代码所需的信息。
NMVIEWCHANGE 存储处理 MCN_VIEWCHANGE 通知代码所需的信息。

常量

主题 目录
月历控件样式 创建月历控件时,使用以下样式常量。

数据类型

主题 目录
MONTHDAYSTATE MONTHDAYSTATE 数据类型是一个位字段,该位字段在一个月内保存每天的状态。