本節包含與日期和時間選擇器控件搭配使用的 API 元素相關信息。
綜述
| 主題 | 內容 |
|---|---|
| 關於日期和時間選擇器控件 |
日期和時間選擇器 (DTP) 控制項 提供簡單且直覺的介面,讓使用者可以透過該介面與使用者交換日期和時間資訊。 |
| 使用日期和時間選擇器控件 | 本節提供實作日期和時間選擇器控件的資訊和範例程序代碼。 |
巨集
| 主題 | 內容 |
|---|---|
| DateTime_CloseMonthCal | 關閉日期和時間選擇器 (DTP) 控制項。 使用此巨集或明確傳送 DTM_CLOSEMONTHCAL 訊息。 |
| DateTime_GetDateTimePickerInfo | 取得指定日期和時間選擇器 (DTP) 控制件的資訊。 |
| DateTime_GetIdealSize | 取得顯示控件而不裁剪所需的大小。 使用此巨集或明確傳送 DTM_GETIDEALSIZE 訊息。 |
| DateTime_GetMonthCal | 取得日期和時間選擇器子月行事歷控件的句柄。 您可以使用這個巨集,或明確傳送 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 | 取得日期和時間選擇器子月行事歷控件的句柄。 您可以明確傳送此訊息,或使用 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(日期時間) 會以 WM_NOTIFY 訊息的形式傳送。 |
| NM_SETFOCUS (日期時間) | 通知日期和時間選擇器控件的父視窗,控制項已收到輸入焦點。
NM_SETFOCUS(日期時間) 會以 WM_NOTIFY 訊息的形式傳送。 |
結構
| 主題 | 內容 |
|---|---|
| DATETIMEPICKERINFO | 包含 DTP 控制件的相關信息。 |
| NMDATETIMECHANGE | 包含日期和時間選擇器 (DTP) 控制項中發生之變更的相關信息。 此結構會與 DTN_DATETIMECHANGE 通知程式代碼搭配使用。 |
| NMDATETIMEFORMAT | 包含格式字串中定義日期和時間選擇器 (DTP) 控制項內回呼欄位的部分資訊。 它會攜帶定義回呼欄位的子字串,並包含緩衝區來接收將在回呼欄位中顯示的字串。 此結構會與 DTN_FORMAT 通知程式代碼搭配使用。 |
| NMDATETIMEFORMATQUERY | 包含日期和時間選擇器 (DTP) 控制項回呼欄位的相關信息。 其中包含定義回呼欄位的子字串(取自控件的格式字串)。 結構會接收將在回呼欄位中顯示的文字允許大小上限。 此結構會與 DTN_FORMATQUERY 通知程式代碼搭配使用。 |
| NMDATETIMESTRING | 包含在日期和時間選擇器 (DTP) 控制項中發生的編輯作業特定資訊。 此訊息會與 DTN_USERSTRING 通知程式代碼搭配使用。 |
| NMDATETIMEWMKEYDOWN | 攜帶用來描述及處理 DTN_WMKEYDOWN 通知碼的資訊。 |
常數
| 主題 | 內容 |
|---|---|
| 日期和時間選擇器控件樣式 | 此處列出的視窗樣式是日期和時間選擇器控制件特有的。 |