在日期時間選擇器控制項中使用回呼欄位
除了定義日期和時間選擇器欄位的標準格式字元以外,您也可以將自訂格式字串的某些部分指定為回呼欄位,以自訂輸出。 若要宣告回呼欄位,請在格式字串主體的任何位置包含一個或多個 "X" 字元 (ASCII 碼 88)。 例如,下列字串 "Today is: 'yy'/'MM'/'dd' (Day 'X')" 可讓日期和時間選擇器控制項以年、月、日、年的天數來顯示目前的值。
注意
回呼欄位的 X 數目不會對應至要顯示的字元數目。
您可以重複 "X" 字元,以區別自訂字串的多個回呼欄位。 因此,格式字串 "XXddddMMMdd', 'yyyXXX" 包含兩個唯一的回呼欄位 "XX" 和 "XXX"。
注意
回呼欄位會被視為有效的欄位,因此您的應用程式必須準備好處理DTN_WMKEYDOWN通知訊息。
實作日期和時間選擇器控制項的回呼欄位,包含三個部分:
初始化自訂格式字串
處理DTN_FORMATQUERY通知
處理DTN_FORMAT通知
初始化自訂格式字串
呼叫 CDateTimeCtrl::SetFormat
以初始化自訂字串。 如需詳細資訊,請參閱 在日期和時間選擇器控制項 中使用自訂格式字串。 設定自訂格式字串的位置通常是在包含對話方塊類別的 OnInitDialog
函式,或是包含檢視類別的 OnInitialUpdate
函式中。
處理 DTN_FORMATQUERY 通知
當控制項剖析格式字串並遇到回呼欄位時,應用程式會傳送DTN_FORMAT和DTN_FORMATQUERY通知訊息。 回呼欄位字串包含通知,讓您可以判斷哪一個回呼欄位正在進行查詢。
系統會傳送DTN_FORMATQUERY通知,以擷取字串的最大允許大小,以圖元為單位,以目前回呼欄位中顯示。
若要適當地計算這個值,您必須使用控制項的顯示字型,計算要替代之欄位的字串高度和寬度。 透過呼叫 GetTextExtentPoint32 Win32 函式,即可輕鬆完成字串的實際計算。 一旦決定大小後,請將值傳遞至應用程式並結束處理函式。
下列範例是一種提供回呼字串大小的方法:
void CMyDialog::OnDtnFormatqueryDatetimepicker1(NMHDR *pNMHDR, LRESULT *pResult)
{
LPNMDATETIMEFORMATQUERY pDTFormatQuery =
reinterpret_cast<LPNMDATETIMEFORMATQUERY>(pNMHDR);
CDC *pDC = NULL;
CFont *pFont = NULL;
CFont *pOrigFont = NULL;
// Prepare the device context for the GetTextExtentPoint32 call.
pDC = GetDC();
if (NULL == pDC)
{
return;
}
pFont = GetFont();
if (NULL == pFont)
{
pFont = new CFont();
VERIFY(pFont->CreateStockObject(DEFAULT_GUI_FONT));
}
pOrigFont = pDC->SelectObject(pFont);
// Check to see if this is the callback segment desired. If so,
// use the longest text segment to determine the maximum
// width of the callback field, and then place the information into
// the NMDATETIMEFORMATQUERY structure.
if (!_tcscmp(_T("X"), pDTFormatQuery->pszFormat))
{
::GetTextExtentPoint32(pDC->m_hDC, _T("366"), 3, &pDTFormatQuery->szMax);
}
// Reset the font in the device context then release the context.
pDC->SelectObject(pOrigFont);
ReleaseDC(pDC);
*pResult = 0;
}
計算目前回呼欄位的大小後,您必須為該欄位提供值。 這會在DTN_FORMAT通知的處理常式中完成。
處理 DTN_FORMAT 通知
應用程式會使用DTN_FORMAT通知來要求將取代的字元字串。 下列範例說明其中一種方法:
void CMyDialog::OnDtnFormatDatetimepicker1(NMHDR *pNMHDR, LRESULT *pResult)
{
LPNMDATETIMEFORMAT pDTFormat = reinterpret_cast<LPNMDATETIMEFORMAT>(pNMHDR);
COleDateTime oCurTime;
m_DateTimeCtrl.GetTime(oCurTime);
_itot_s(oCurTime.GetDayOfYear(), pDTFormat->szDisplay,
sizeof(pDTFormat->szDisplay) / sizeof(TCHAR), 10);
*pResult = 0;
}
注意
找到 NMDATETIMEFORMAT 結構的指標 ,方法是將通知處理常式的第一個參數轉換成適當的類型。