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 字元。 (如需回呼字段的詳細資訊，請參閱 回呼 fields.)

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