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