文/劉濤
前言：
控件在Visual C++編程學(xué)習(xí)中占據(jù)很重要的位置。筆者在國(guó)外英文網(wǎng)站上看到了這篇關(guān)于日歷控件學(xué)習(xí)的文章，雖然內(nèi)容看似簡(jiǎn)單，但讀完后感覺到還是學(xué)到了一些東西。感覺到原著作者對(duì)一些不常用的日歷控制的使用方法寫的介紹的很詳細(xì)，通俗易懂，于平淡之中顯神奇，是對(duì)日歷控件的"深度挖掘"，對(duì)VC的初學(xué)者應(yīng)該是很有幫助的，所以就將其翻譯過來介紹給國(guó)內(nèi)讀者朋友。
一、有關(guān)日歷控件的介紹
Win32 API提供了一個(gè)顯示日期得當(dāng)彩色日歷控件，日期的顯示模式是基于控制面板中的區(qū)域性設(shè)置或者說是依賴于用戶的操作系統(tǒng)。具體的日歷控件如下圖一所示：
 圖一、日歷控件顯示效果 |
這個(gè)常用的日歷控件的標(biāo)題條包含兩個(gè)按鈕和兩個(gè)標(biāo)簽，左邊的按鈕準(zhǔn)許用戶單擊選擇前一個(gè)月份，左邊的標(biāo)簽顯示當(dāng)前選擇的月份，右邊的標(biāo)簽顯示當(dāng)前日期中的年份。右邊的按鈕是讓用戶選擇下一個(gè)月份。日歷控件可以配置成顯示多個(gè)月份，下圖是一具體的實(shí)例：
 圖二、顯示多個(gè)月份的日歷控件 |
如果要讓日歷控件顯示多個(gè)月份，按鈕的個(gè)數(shù)將通過前月或后月列表來增加或減少。例如，如果控件正在顯示4月或5月，這時(shí)用戶點(diǎn)擊了左邊的按鈕，控件將顯示3月或4月；如果用戶點(diǎn)擊了右邊的按鈕，控件將顯示5月和6月。此外，選擇當(dāng)前年份中的任意一個(gè)月份，用戶可以點(diǎn)擊標(biāo)題框中的月份名，這時(shí)候?qū)@示一個(gè)月份列表供用戶來選擇。具體如圖所示：
 圖三、顯示月份列表 |
如果要更改年份，用戶可以點(diǎn)擊年份標(biāo)簽，這時(shí)候?qū)@示旋轉(zhuǎn)按鈕，用戶可以通過點(diǎn)擊旋轉(zhuǎn)按鈕的上下鍵來更改年份，也可以使用鍵盤上的上下箭頭來更改年份。
 圖四、更改日歷控件的年份 |
在標(biāo)題條的下面，根據(jù)控制面板的格式顯示著星期的簡(jiǎn)寫，在英語地區(qū)，每個(gè)星期的第一天通常是星期天。開發(fā)人員可以改變控件中的第一天設(shè)置。
控件上，當(dāng)前選擇的日期有一圓圈。用戶可以點(diǎn)擊欲選擇的日期來在控件上選擇一個(gè)日期。在大部分地區(qū)，日期以數(shù)字的形式顯現(xiàn)在一個(gè)白色背景上（這個(gè)背景顏色乃至控件上的任何顏色可以通過程序來改變）。默認(rèn)的情況下，控件顯示一個(gè)橢圓圍繞的當(dāng)前日期。使用標(biāo)題條按鈕、月份和年份標(biāo)簽，用戶可以更改日期。如果控件顯示的不是當(dāng)前日期，用戶可以通過點(diǎn)擊控件底部顯示今天日期的標(biāo)簽來使控件顯示今天的日期。（如果你是一個(gè)程序員，可以隱藏控件底部這個(gè)顯示今日日期的標(biāo)簽）。
二、創(chuàng)建日歷控件
我們可以在窗口、對(duì)話框架、工具條及其他任何容器窗口中創(chuàng)建日歷控件。日歷控件對(duì)應(yīng)著CmonthCalCtrl類，所以要?jiǎng)討B(tài)創(chuàng)建一個(gè)日歷控件，需要聲明一個(gè)CmonthCalCtrl變量或指向CmonthCalCtrl的指針，代碼如下：
// Exercise1Dlg.h : header file
class CExercise1Dlg : public CDialog
{
// Construction
public:
CExercise1Dlg(CWnd* pParent = NULL); // standard constructor
private:
CMonthCalCtrl *ctlCalendar;
};
|
CmonthCalCtrl類象MFC中其他控件對(duì)應(yīng)的類一樣，提供了一個(gè)Create()方法用來在容器窗口中動(dòng)態(tài)創(chuàng)建日歷控件，代碼如下：
CExercise1Dlg::CExercise1Dlg(CWnd* pParent /*=NULL*/)
: CDialog(CExercise1Dlg::IDD, pParent)
{
//{{AFX_DATA_INIT(CExercise1Dlg)
//}}AFX_DATA_INIT
// Note that LoadIcon does not require a subsequent DestroyIcon in Win32
m_hIcon = AfxGetApp()->LoadIcon(IDR_MAINFRAME);
ctlCalendar = new CMonthCalCtrl;
}
/////////////////////////////////////////////////////////////////////////////
// CExercise1Dlg message handlers
BOOL CExercise1Dlg::OnInitDialog()
{
CDialog::OnInitDialog();
// Set the icon for this dialog. The framework does this automatically
// when the application's main window is not a dialog
SetIcon(m_hIcon, TRUE); // Set big icon
SetIcon(m_hIcon, FALSE); // Set small icon
// TODO: Add extra initialization here
ctlCalendar->Create(WS_TABSTOP | WS_CHILD | WS_VISIBLE | WS_BORDER,CPoint(20, 20), this, 0x224);
return TRUE; // return TRUE unless you set the focus to a control
} |
三、日歷控件屬性操作
在對(duì)話框或窗口中創(chuàng)建一個(gè)日歷控件后，它僅顯示當(dāng)前的月份并僅僅只能顯示一個(gè)月份，這是因?yàn)椋凑漳J(rèn)的設(shè)計(jì)，控件的長(zhǎng)、寬、高只能容納一個(gè)月的日期，如果要顯示兩個(gè)月，就要增加控件的寬度（同樣的道理，也可以通過增加高度來顯示兩個(gè)月份）。
作為一個(gè)可視化對(duì)象，日歷控件可以用不同的顏色來表現(xiàn)背景、星期日、標(biāo)題條文本、標(biāo)題條背景等。作為開發(fā)人員理所當(dāng)然地可以通過程序來更換這些顏色，當(dāng)然是要在不影響控件親合力的情況下。改變?nèi)諝v控件的顏色，需要調(diào)用CMonthCalCtrl::SetColor() 方法，該方法的語法是：
| COLORREF SetColor(int nRegion, COLORREF ref); |
默認(rèn)情況下，控件的標(biāo)題條顯示藍(lán)色背景，如果要改變它，需要向nRegion參數(shù)傳遞MCSC_TITLEBK值，向ref參數(shù)傳遞你所要顯示的顏色。如果更改標(biāo)題條上文本的顏色，需要向nRegion參數(shù)傳遞MCSC_TITLETEXT值。
  圖五、更改控件的標(biāo)題條顏色 |
上文說過，在標(biāo)題條的下方顯示著星期日，在英語國(guó)家，一個(gè)星期的第一天是星期天，如果你想更改一個(gè)星期的第一天，可以調(diào)用函數(shù)SetFirstDayOfWeek()，它的語法是：
| BOOL SetFirstDayOfWeek(int iDay, int* lpnOld = NULL); |
第一個(gè)參數(shù)必須是對(duì)應(yīng)的下列整數(shù)值：
| Value |
Weekday |
| 0 |
Monday |
| 1 |
Tuesday |
| 2 |
Wednesday |
| 3 |
Thursday |
| 4 |
Friday |
| 5 |
Saturday |
| 6 |
Sunday |
如果想要獲知日歷控件的星期天中具體哪一天設(shè)置為第一天，可以調(diào)用函數(shù)：GetFirstDayOfWeek()，它的語法是：
| int GetFirstDayOfWeek(BOOL* pbLocal = NULL) const; |
該函數(shù)返回一個(gè)整數(shù)值，它對(duì)應(yīng)的含義與上個(gè)表格一致。
星期日的名字使用的顏色與使用SetColor()函數(shù)傳遞MCSC_TITLETEXT時(shí)使用的顏色一致，在星期日的下面是一個(gè)水平分割線，默認(rèn)情況下它該是黑色的，但這里它卻與選擇的日期一個(gè)顏色。在分割線下是日期列表，默認(rèn)情況下背景是Windows默認(rèn)的白色，如果要改變它，需要向nRegion參數(shù)傳遞MCSC_MONTHBK值，向ref參數(shù)傳遞你所要顯示的顏色。
表示日期的數(shù)字顯示有兩種顏色，當(dāng)前選擇的月份中的日期以黑色表示，如果要改變這種顏色，可以向需要向nRegion參數(shù)傳遞MCSC_TRAILINGTEXT值，向ref參數(shù)傳遞你所要顯示的顏色。
  圖六、更改日歷控件的日期顯示顏色 |
分割線下的日期列表以兩種顏色顯示，為了規(guī)定當(dāng)前月份中日期的顏色，可以向需要向nRegion參數(shù)傳遞MCSC_TEXT值，向ref參數(shù)傳遞你所要顯示的顏色。
日歷控件習(xí)慣于用兩種形式來讓用戶了解當(dāng)前的日期，一是在列表中以橢圓將當(dāng)前日期圈起來，另一種方式是在底部以句子的形式顯示。在創(chuàng)建控件時(shí)，將"today"屬性設(shè)置為"NO"將不顯示今天的日期。
 圖七、不顯示"今日"標(biāo)簽的日歷控件 |
如上所述，默認(rèn)情況下控件顯示今天日期，可以通過編程使用MCS_NOTODAY來隱藏這個(gè)標(biāo)簽，代碼如下：
BOOL CExercise1Dlg::OnInitDialog()
{
CDialog::OnInitDialog();
// Set the icon for this dialog. The framework does this automatically
// when the application's main window is not a dialog
SetIcon(m_hIcon, TRUE); // Set big icon
SetIcon(m_hIcon, FALSE); // Set small icon
// TODO: Add extra initialization here
ctlCalendar->Create(WS_TABSTOP | WS_CHILD |
WS_VISIBLE | WS_BORDER | MCS_NOTODAY,
CPoint(20, 20), this, 0x224);
return TRUE; // return TRUE unless you set the focus to a control
} |
我們注意到， 當(dāng)前日期還被一個(gè)橢圓圈了起來，如果要將它隱藏起來，應(yīng)該使用MCS_NOTODAYCIRCLE類型，代碼如下：
BOOL CExercise1Dlg::OnInitDialog()
{
CDialog::OnInitDialog();
// Set the icon for this dialog. The framework does this automatically
// when the application's main window is not a dialog
SetIcon(m_hIcon, TRUE); // Set big icon
SetIcon(m_hIcon, FALSE); // Set small icon
// TODO: Add extra initialization here
ctlCalendar->Create(WS_TABSTOP | WS_CHILD |
WS_VISIBLE | WS_BORDER |
MCS_NOTODAYCIRCLE,
CPoint(20, 20), this, 0x224);
return TRUE; // return TRUE unless you set the focus to a control
} |
為了獲取當(dāng)前日歷控件中選擇的日期，可以使用方法：CMonthCalCtrl::GetCurSel()，該方法重載有3個(gè)版本，它們是：
BOOL GetCurSel(COleDateTime& refDateTime) const;
BOOL GetCurSel(CTime& refDateTime) const;
BOOL GetCurSel(LPSYSTEMTIME pDateTime) const; |
這里有一個(gè)例子：
void CExercise1Dlg::OnRetrieveBtn()
{
// TODO: Add your control notification handler code here
UpdateData();
CTime tme = this->m_dtpCurrent.GetCurrentTime();
this->m_Result.Format("%s", tme.Format("%A, %B %d, %Y"));
UpdateData(FALSE);
} |
為了控制用戶是否可以選擇兩個(gè)以上的日期，在創(chuàng)建控件時(shí)可以相應(yīng)地設(shè)置多項(xiàng)選擇屬性。例如，如果你想讓用戶在控件中選擇一定范圍的日期，可以將多項(xiàng)選擇屬性設(shè)置為真。為了動(dòng)態(tài)設(shè)置多日期選擇，應(yīng)用MCS_MULTISELECT屬性，代碼如下：
BOOL CExercise1Dlg::OnInitDialog()
{
CDialog::OnInitDialog();
// Set the icon for this dialog. The framework does this automatically
// when the application's main window is not a dialog
SetIcon(m_hIcon, TRUE); // Set big icon
SetIcon(m_hIcon, FALSE); // Set small icon
// TODO: Add extra initialization here
ctlCalendar->Create(WS_TABSTOP | WS_CHILD |
WS_VISIBLE | WS_BORDER |
MCS_NOTODAYCIRCLE | MCS_MULTISELECT,
CPoint(20, 20), this, 0x224);
return TRUE; // return TRUE unless you set the focus to a control
} |
 圖八、顯示多選擇日期的日歷控件 |
通過屬性設(shè)置，用戶可以在日歷控件中選擇多個(gè)日期，當(dāng)然，也可以通過動(dòng)態(tài)編程來選擇多個(gè)日期，這時(shí)，可以調(diào)用CMonthCalCtrl::SetSelRange()方法，它有三個(gè)不同的版本，語法是：
BOOL SetSelRange(const COleDateTime& pMinRange, const COleDateTime& pMaxRange);
BOOL SetSelRange(const CTime& pMinRange, const CTime& pMaxRange);
BOOL SetSelRange(const LPSYSTEMTIME pMinRange, const LPSYSTEMTIME pMaxRange); |
如果想獲取一個(gè)日歷控件的可選擇范圍，可以調(diào)用CMonthCalCtrl::GetSelRange() 方法。
為了控制用戶可選擇的日期范圍，可以調(diào)用CMonthCalCtrl::SetRange()方法，它也有三中不同的形式，分別是：
BOOL SetRange(const COleDateTime* pMinRange, const COleDateTime* pMaxRange);
BOOL SetRange(const CTime* pMinRange, const CTime* pMaxRange);
BOOL SetRange(const LPSYSTEMTIME pMinRange, const LPSYSTEMTIME pMaxRange); |
第一個(gè)參數(shù)nMinRange是選擇范圍的開始日期，參數(shù)nMaxRange是可供選擇的最大日期。