DateTime_SetRange 宏 (commctrl.h)

为日期和时间选取器 (DTP) 控件设置允许的最小和最大系统时间。 可以使用此宏或显式发送 DTM_SETRANGE 消息。

语法

BOOL DateTime_SetRange(
   HWND         hdp,
   DWORD        gd,
   LPSYSTEMTIME rgst
);

参数

hdp

类型:HWND

DTP 控件的句柄。

gd

类型:DWORD

一个值,该值指定哪些范围值有效。 此值可以是以下内容的组合:

价值 意义
GDTR_MIN
SYSTEMTIME 结构数组中的第一个元素有效,将用于设置允许的最小系统时间。
GDTR_MAX
SYSTEMTIME 结构数组中的第二个元素有效,将用于设置允许的最大系统时间。

rgst

类型:LPSYSTEMTIME

指向 SYSTEMTIME 结构的双元素数组的指针。 SYSTEMTIME 数组的第一个元素包含允许的最小时间。 SYSTEMTIME 数组的第二个元素包含允许的最大时间。 无需填充未在 gd 参数中指定的数组元素。

返回值

类型:BOOL

如果成功,则返回非零;否则返回零。

言论

日期和时间选取器仅显示位于指定范围内的日期/时间,从而阻止用户选择超出范围的日期和时间。 如果 DateTime_SetSystemtime 消息指定超出范围的日期和时间,它将失败。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 commctrl.h