日期和时间选取器

项目
03/06/2024

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

概述

主题	目录
关于日期和时间选取器控件	日期和时间选取器 (DTP) 控件提供一个简单直观的界面，通过该界面与用户交换日期和时间信息。
使用日期和时间选取器控件	本部分提供用于实现日期和时间选取器控件的信息和示例代码。

宏

主题	目录
DateTime_CloseMonthCal	关闭日期和时间选取器 (DTP) 控件。使用此宏，或显式发送 DTM_CLOSEMONTHCAL 消息。
DateTime_GetDateTimePickerInfo	获取指定日期和时间选取器 (DTP) 控件的信息。
DateTime_GetIdealSize	获取在不剪裁的情况下显示控件所需的大小。使用此宏，或显式发送 DTM_GETIDEALSIZE 消息。
DateTime_GetMonthCal	获取日期和时间选取器 (DTP) 的子月历控件的句柄。可以使用此宏，或显式发送 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	获取日期和时间选取器 (DTP) 的子月历控件的句柄。可以显式发送此消息或使用 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 (date time) 以 WM_NOTIFY 的形式发送。
NM_SETFOCUS（日期时间）	通知日期和时间选取器控件的父窗口，该控件已收到输入焦点。 NM_SETFOCUS (date time) 以 WM_NOTIFY 消息的形式发送。

结构

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

常量

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