通过

日期和时间选取器

本部分包含有关用于日期和时间选取器控件的 API 元素的信息。

综述

主题 内容
关于日期和时间选取器控件 日期和时间选取器（DTP）控件 提供了一个简单直观的界面，用于与用户交换日期和时间信息。
使用日期和时间选取器控件 本部分提供用于实现日期和时间选取器控件的信息和示例代码。

宏

主题 内容
DateTime_CloseMonthCal 关闭日期和时间选取器（DTP）控件。 使用此宏或显式发送 DTM_CLOSEMONTHCAL 消息。
DateTime_GetDateTimePickerInfo 获取指定日期和时间选取器 （DTP） 控件的信息。
DateTime_GetIdealSize 获取在不剪裁的情况下显示控件所需的大小。 使用此宏或显式发送 DTM_GETIDEALSIZE 消息。
DateTime_GetMonthCal 获取日期和时间选取器的子月日历控件的句柄。 可以使用此宏或显式发送 DTM_GETMONTHCAL 消息。
DateTime_GetMonthCalColor 获取日期和时间选取器 （DTP） 控件中月份日历的给定部分的颜色。 可以使用此宏或显式发送 DTM_GETMCCOLOR 消息。
DateTime_GetMonthCalFont 获取日期和时间选取器（DTP）控件的子月日历控件当前使用的字体。 可以使用此宏或显式发送 DTM_GETMCFONT 消息。
DateTime_GetMonthCalStyle 获取指定 DTP 控件的样式。 使用此宏或显式发送 DTM_GETMCSTYLE 消息。
DateTime_GetRange 获取日期和时间选取器 （DTP） 控件的当前最小和允许的系统时间。 可以使用此宏，或显式发送 DTM_GETRANGE 消息。
DateTime_GetSystemtime 从日期和时间选取器（DTP）控件中获取当前选定的时间，并将其置于指定的 SYSTEMTIME 结构中。 可以使用此宏，或显式发送 DTM_GETSYSTEMTIME 消息。
DateTime_SetFormat 设置基于给定格式字符串的日期和时间选取器（DTP）控件的显示。 可以使用此宏或显式发送 DTM_SETFORMAT 消息。
DateTime_SetMonthCalColor 在日期和时间选取器（DTP）控件中设置月历的给定部分的颜色。 可以使用此宏或显式发送 DTM_SETMCCOLOR 消息。
DateTime_SetMonthCalFont 设置日期和时间选取器 （DTP） 控件子月日历控件要使用的字体。 可以使用此宏或显式发送 DTM_SETMCFONT 消息。
DateTime_SetMonthCalStyle 设置指定 DTP 控件的样式。 使用此宏或显式发送 DTM_SETMCSTYLE 消息。
DateTime_SetRange 为日期和时间选取器 （DTP） 控件设置允许的最小和最大系统时间。 可以使用此宏或显式发送 DTM_SETRANGE 消息。
DateTime_SetSystemtime 将日期和时间选取器 （DTP） 控件设置为给定的日期和时间。 可以使用此宏或显式发送 DTM_SETSYSTEMTIME 消息。

消息

主题 内容
DTM_CLOSEMONTHCAL 关闭 DTP 控件。 显式发送此消息或使用 DateTime_CloseMonthCal 宏发送。
DTM_GETDATETIMEPICKERINFO 获取日期和时间选取器（DTP）控件的相关信息。
DTM_GETIDEALSIZE 获取在不剪裁的情况下显示控件所需的大小。 显式发送此消息或使用 DateTime_GetIdealSize 宏发送。
DTM_GETMCCOLOR 获取日期和时间选取器 （DTP） 控件中月份日历的给定部分的颜色。 可以显式发送此消息或使用 DateTime_GetMonthCalColor 宏。
DTM_GETMCFONT 获取日期和时间选取器（DTP）控件的子月日历控件当前使用的字体。 可以显式发送此消息或使用 DateTime_GetMonthCalFont 宏。
DTM_GETMCSTYLE 获取 DTP 控件的样式。 显式发送此消息或使用 DateTime_GetMonthCalStyle 宏发送。
DTM_GETMONTHCAL 获取日期和时间选取器的子月日历控件的句柄。 可以显式发送此消息或使用 DateTime_GetMonthCal 宏。
DTM_GETRANGE 获取日期和时间选取器 （DTP） 控件的当前最小和允许的系统时间。 可以显式发送此消息或使用 DateTime_GetRange 宏。
DTM_GETSYSTEMTIME 从日期和时间选取器（DTP）控件中获取当前选定的时间，并将其置于指定的 SYSTEMTIME 结构中。 可以显式发送此消息或使用 DateTime_GetSystemtime 宏。
DTM_SETFORMAT 设置基于给定格式字符串的日期和时间选取器（DTP）控件的显示。 可以显式发送此消息或使用 DateTime_SetFormat 宏。
DTM_SETMCCOLOR 在日期和时间选取器（DTP）控件中设置月历的给定部分的颜色。 可以显式发送此消息或使用 DateTime_SetMonthCalColor 宏。
DTM_SETMCFONT 设置日期和时间选取器 （DTP） 控件子月日历控件要使用的字体。 可以显式发送此消息或使用 DateTime_SetMonthCalFont 宏。
DTM_SETMCSTYLE 设置 DTP 控件的样式。 显式发送此消息或使用 DateTime_SetMonthCalStyle 宏发送。
DTM_SETRANGE 为日期和时间选取器 （DTP） 控件设置允许的最小和最大系统时间。 可以显式发送此消息或使用 DateTime_SetRange 宏。
DTM_SETSYSTEMTIME 设置日期和时间选取器 （DTP） 控件中的时间。 可以显式发送此消息或使用 DateTime_SetSystemtime 宏。

通知

主题 内容
DTN_CLOSEUP 当用户关闭下拉月日历时，按日期和时间选取器（DTP）控件发送。 当用户从月日历中选择日期或单击日历打开时单击下拉箭头时，月份日历将关闭。
DTN_DATETIMECHANGE 每当发生更改时，日期和时间选取器（DTP）控件发送。 此通知代码以 WM_NOTIFY 消息的形式发送。
DTN_DROPDOWN 当用户激活下拉月日历时，按日期和时间选取器（DTP）控件发送。
DTN_FORMAT 按日期和时间选取器 （DTP） 控件发送以请求在回调字段中显示的文本。 此通知代码以 WM_NOTIFY 消息的形式发送。
DTN_FORMATQUERY 由日期和时间选取器 （DTP） 控件发送，以检索将在回调字段中显示的字符串的最大允许大小。 此通知代码以 WM_NOTIFY 消息的形式发送。
DTN_USERSTRING 当用户在控件中完成编辑字符串时，由日期和时间选取器 （DTP） 控件发送。 此通知代码仅由设置为 DTS_APPCANPARSE 样式的 DTP 控件发送。 此消息以 WM_NOTIFY 消息的形式发送。
DTN_WMKEYDOWN 用户键入回调字段中的日期和时间选取器 （DTP） 控件发送。 此消息以 WM_NOTIFY 消息的形式发送。
NM_KILLFOCUS（日期时间） 通知日期和时间选取器控件的父窗口，该控件已失去输入焦点。 NM_KILLFOCUS（日期时间） 以 WM_NOTIFY 邮件的形式发送。
NM_SETFOCUS （日期时间） 通知日期和时间选取器控件的父窗口，该控件已收到输入焦点。 NM_SETFOCUS（日期时间） 以 WM_NOTIFY 消息的形式发送。

结构

主题 内容
DATETIMEPICKERINFO 包含有关 DTP 控件的信息。
NMDATETIMECHANGE 包含有关日期和时间选取器 （DTP） 控件中发生的更改的信息。 此结构与 DTN_DATETIMECHANGE 通知代码一起使用。
NMDATETIMEFORMAT 包含有关在日期和时间选取器（DTP）控件中定义回调字段的格式字符串的一部分的信息。 它承载定义回调字段的子字符串，并包含一个缓冲区，用于接收将在回调字段中显示的字符串。 此结构与 DTN_FORMAT 通知代码一起使用。
NMDATETIMEFORMATQUERY 包含有关日期和时间选取器（DTP）控件回调字段的信息。 它包含定义回调字段的子字符串（取自控件的格式字符串）。 该结构接收将在回调字段中显示的文本的最大允许大小。 此结构与 DTN_FORMATQUERY 通知代码一起使用。
NMDATETIMESTRING 包含特定于日期和时间选取器 （DTP） 控件中发生的编辑作的信息。 此消息与 DTN_USERSTRING 通知代码一起使用。
NMDATETIMEWMKEYDOWN 携带用于描述和处理 DTN_WMKEYDOWN 通知代码的信息。

常数

主题 内容
日期和时间选取器控件样式 此处列出的窗口样式特定于日期和时间选取器控件。