NMDATETIMEFORMATA 结构 (commctrl.h)

包含有关在日期和时间选取器(DTP)控件中定义回调字段的格式字符串的一部分的信息。 它承载定义回调字段的子字符串,并包含一个缓冲区,用于接收将在回调字段中显示的字符串。 此结构与 DTN_FORMAT 通知代码一起使用。

语法

typedef struct tagNMDATETIMEFORMATA {
  NMHDR      nmhdr;
  LPCSTR     pszFormat;
  SYSTEMTIME st;
  LPCSTR     pszDisplay;
  CHAR       szDisplay[64];
} NMDATETIMEFORMATA, *LPNMDATETIMEFORMATA;

成员

nmhdr

类型:NMHDR

包含通知代码信息的 NMHDR 结构。

pszFormat

类型:LPCTSTR

指向定义 DTP 控件回调字段的子字符串的指针。 子字符串由一个或多个“X”字符组成,后跟 NULL 字符。 (有关回调字段的详细信息,请参阅 回调字段。)

st

类型:SYSTEMTIME

SYSTEMTIME 结构,其中包含要设置格式的日期和时间。

pszDisplay

类型:LPCTSTR

指向包含控件显示文本的以 null 结尾的字符串的指针。 默认情况下,这是此结构的 szDisplay 成员的地址。 可以接受 pszDisplay 指向现有字符串。 在这种情况下,无需将值分配给 szDisplay 。 但是,pszDisplay 指向的字符串必须保持有效,直到发送另一个 DTN_FORMAT 通知,或直到控件被销毁。

szDisplay[64]

类型:TCHAR

64 个字符的缓冲区,用于接收 DTP 控件将显示的零终止字符串。 无需填充整个缓冲区。

言论

注意

commctrl.h 标头将 NMDATETIMEFORMAT 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

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