`CDateTimeCtrl` 類別

發行項
07/05/2024

封裝日期與時間選擇器控制項的功能。

語法

class CDateTimeCtrl : public CWnd

成員

公用建構函式

名稱	描述
`CDateTimeCtrl::CDateTimeCtrl`	建構 `CDateTimeCtrl` 物件。

公用方法

名稱	描述
`CDateTimeCtrl::CloseMonthCal`	關閉目前的日期和時間選擇器控制件。
`CDateTimeCtrl::Create`	建立日期和時間選擇器控件，並將它附加至 `CDateTimeCtrl` 物件。
`CDateTimeCtrl::GetDateTimePickerInfo`	擷取目前日期和時間選擇器控件的相關信息。
`CDateTimeCtrl::GetIdealSize`	傳回顯示目前日期或時間所需之日期和時間選擇器控件的理想大小。
`CDateTimeCtrl::GetMonthCalColor`	擷取日期和時間選擇器控件內月曆指定部分的色彩。
`CDateTimeCtrl::GetMonthCalCtrl`	`CMonthCalCtrl`擷取與日期和時間選擇器控件相關聯的物件。
`CDateTimeCtrl::GetMonthCalFont`	擷取日期和時間選擇器控件子月曆控件目前使用的字型。
`CDateTimeCtrl::GetMonthCalStyle`	取得目前日期和時間選擇器控件的樣式。
`CDateTimeCtrl::GetRange`	擷取日期和時間選擇器控制項目前允許的系統時間下限和最大值。
`CDateTimeCtrl::GetTime`	從日期和時間選擇器控件擷取目前選取的時間，並將其放入指定的 `SYSTEMTIME` 結構中。
`CDateTimeCtrl::SetFormat`	根據指定的格式字串，設定日期和時間選擇器控件的顯示。
`CDateTimeCtrl::SetMonthCalColor`	設定日期和時間選擇器控件內月曆指定部分的色彩。
`CDateTimeCtrl::SetMonthCalFont`	設定日期和時間選擇器控件子月曆控件將使用的字型。
`CDateTimeCtrl::SetMonthCalStyle`	設定目前日期和時間選擇器控件的樣式。
`CDateTimeCtrl::SetRange`	設定日期和時間選擇器控件的最小和允許系統時間上限。
`CDateTimeCtrl::SetTime`	設定日期和時間選擇器控件中的時間。

備註

日期和時間選擇器控制件（DTP 控制項）提供簡單的介面，可與使用者交換日期和時間資訊。這個介面包含欄位，每個字段都會顯示儲存在控件中的日期和時間資訊的一部分。用戶可以變更指定欄位中字串的內容，來變更控件中儲存的資訊。用戶可以使用滑鼠或鍵盤，從欄位移至欄位。

您可以在建立物件時，將各種樣式套用至物件，以自定義日期和時間選擇器控件。如需日期和時間選擇器控件控制項特定樣式的詳細資訊，請參閱 Windows SDK 中的日期和時間選擇器控制件樣式。您可以使用格式樣式來設定 DTP 控制件的顯示格式。 Windows SDK 主題的日期和時間選擇器控件樣式中的「格式樣式」底下會描述這些格式樣式。

日期和時間選擇器控件也會使用通知和回呼，如使用 CDateTimeCtrl中所述。

繼承階層架構

CObject

CCmdTarget

CWnd

CDateTimeCtrl

需求

標頭： afxdtctl.h

`CDateTimeCtrl::CDateTimeCtrl`

建構 CDateTimeCtrl 物件。

CDateTimeCtrl();

`CDateTimeCtrl::CloseMonthCal`

關閉目前的日期和時間選擇器控制件。

void CloseMonthCal() const;

備註

這個方法會傳送 DTM_CLOSEMONTHCAL 訊息，如 Windows SDK 中所述。

範例

第一個程式代碼範例會定義變數，該變數 m_dateTimeCtrl用來以程式設計方式存取日期和時間選擇器控件。下一個範例中會使用此變數。

// Variable to access date-time control.
CDateTimeCtrl m_dateTimeCtrl;
// Variable to access the splitbutton control
CSplitButton m_splitbutton;

下一個程式代碼範例會關閉目前日期和時間選擇器控件的下拉式行事曆。

void CCDateTimeCtrl_s1Dlg::OnXClosemonthcal()
{
   // Close the month calendar control dropdown.
   m_dateTimeCtrl.CloseMonthCal();
}

`CDateTimeCtrl::Create`

建立日期和時間選擇器控件，並將它附加至 CDateTimeCtrl 物件。

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

參數

dwStyle
指定日期時間控制樣式的組合。如需日期和時間選擇器樣式的詳細資訊，請參閱 Windows SDK 中的日期和時間選擇器控件樣式。

rect
結構的參考 RECT ，這是日期和時間選擇器控件的位置和大小。

pParentWnd
物件的指標 CWnd ，該物件是日期和時間選擇器控件的父視窗。它不得為 NULL。

nID
指定日期和時間選擇器控制件的控制項識別碼。

傳回值

如果建立成功，則為非零;否則為 0。

備註

建立日期和時間選擇器控制件

呼叫 CDateTimeCtrl 以建構 CDateTimeCtrl 物件。
呼叫這個成員函式，此函式會建立 Windows 日期和時間選擇器控件，並將它附加至 CDateTimeCtrl 物件。

當您呼叫 Create時，會初始化通用控件。

範例

// choose an arbitrary rectangle for creation
CRect rect(20, 20, 120, 45);
m_DateTimeCtrl.Create(WS_VISIBLE | WS_CHILD | WS_TABSTOP | DTS_SHOWNONE |
                          DTS_SHORTDATEFORMAT,
                      rect, this, IDC_DATETIMECTRL);

`CDateTimeCtrl::GetDateTimePickerInfo`

擷取目前日期和時間選擇器控件的相關信息。

BOOL GetDateTimePickerInfo(LPDATETIMEPICKERINFO pDateTimePickerInfo) const;

參數

pDateTimePickerInfo
[out]結構的指標 DATETIMEPICKERINFO ，可接收目前日期和時間選擇器控件的描述。呼叫端負責配置此結構。不過，這個方法會 cbSize 初始化結構的成員。

傳回值

TRUE 如果此方法成功，則為 ;否則為 FALSE。

備註

這個方法會傳送 DTM_GETDATETIMEPICKERINFO 訊息，如 Windows SDK 中所述。

範例

第一個程式代碼範例會定義變數，該變數 m_dateTimeCtrl用來以程式設計方式存取日期和時間選擇器控件。下一個範例中會使用此變數。

// Variable to access date-time control.
CDateTimeCtrl m_dateTimeCtrl;
// Variable to access the splitbutton control
CSplitButton m_splitbutton;

下一個程式代碼範例指出它是否成功擷取目前日期和時間選擇器控件的相關信息。

void CCDateTimeCtrl_s1Dlg::OnXGetdatetimepickerinfo()
{
   // Get information about the date-time picker control.
   DATETIMEPICKERINFO dtpi = {0};
   dtpi.cbSize = sizeof(DATETIMEPICKERINFO);
   BOOL rc = m_dateTimeCtrl.GetDateTimePickerInfo(&dtpi);
   if (rc == TRUE)
      AfxMessageBox(_T("Information retrieved"),
                    MB_ICONEXCLAMATION);
   else
      AfxMessageBox(_T("Information was not retrieved"));
}

`CDateTimeCtrl::GetMonthCalColor`

擷取日期和時間選擇器控件內月曆指定部分的色彩。

COLORREF GetMonthCalColor(int iColor) const;

參數

iColor
值 int ，指定要擷取之月曆的色彩區域。如需值清單，請參閱 iColor 的參數 SetMonthCalColor。

傳回值

COLORREF值，表示如果成功，則表示月曆控件指定部分的色彩設定。如果失敗，函式會傳回 -1。

備註

此成員函式會實作 Win32 訊息 DTM_GETMCCOLOR 的行為，如 Windows SDK 中所述。

範例

// Set the color for the text in the control and
// assure it was set properly. Unlike the GetMonthCalCtrl() member,
// GetMonthCalColor() and SetMonthCalColor() can be used at any time.
m_DateTimeCtrl.SetMonthCalColor(MCSC_TEXT, RGB(255, 0, 0));
VERIFY(m_DateTimeCtrl.GetMonthCalColor(MCSC_TEXT) == RGB(255, 0, 0));

`CDateTimeCtrl::GetMonthCalCtrl`

CMonthCalCtrl擷取與日期和時間選擇器控件相關聯的物件。

CMonthCalCtrl* GetMonthCalCtrl() const;

傳回值

物件的指標 CMonthCalCtrl ，如果 NULL 失敗，或視窗不可見則為。

備註

當用戶選取下拉式箭號時，日期和時間選擇器控件會建立子月行事歷控件。 CMonthCalCtrl當不再需要物件時，它就會終結，因此您的應用程式不得依賴儲存代表日期時間選擇器控件子月曆的物件。

範例

void CDateTimeDlg::OnDropDownDateTimeCtrl(NMHDR *pNMHDR, LRESULT *pResult)
{
   UNREFERENCED_PARAMETER(pNMHDR);

   // note that GetMonthCalCtrl() will only return a pointer to the
   // month calendar control while the control actually exists--that is,
   // while it has been dropped-down by the user. Otherwise, the function
   // returns NULL. One appropriate time to get the control is while
   // handling the DTN_DROPDOWN notification for the date time picker
   // control.

   // get the control
   CMonthCalCtrl *pMoCalCtrl = m_DateTimeCtrl.GetMonthCalCtrl();
   ASSERT(pMoCalCtrl != NULL);

   // now, pMoCalCtrl is useful...

   *pResult = 0;
}

`CDateTimeCtrl::GetMonthCalFont`

取得日期和時間選擇器控件的月曆控件目前使用的字型。

CFont* GetMonthCalFont() const;

傳回值

物件的指標 CFont ，如果 NULL 失敗則為。

備註

傳 CFont 回值所指向的物件是暫存物件，並在下一個閑置處理時間期間終結。

`CDateTimeCtrl::GetMonthCalStyle`

取得與目前日期和時間選擇器控件相關聯的下拉式月曆控件樣式。

DWORD GetMonthCalStyle() const;

傳回值

下拉式月曆控件的樣式，這是日期和時間選擇器控件樣式的位組合（OR）。如需詳細資訊，請參閱月曆控件樣式。

備註

這個方法會傳送 DTM_GETMCSTYLE 訊息，如 Windows SDK 中所述。

`CDateTimeCtrl::GetRange`

擷取日期和時間選擇器控制項目前允許的系統時間下限和最大值。

DWORD GetRange(
    COleDateTime* pMinRange,
    COleDateTime* pMaxRange) const;

DWORD GetRange(
    CTime* pMinRange,
    CTime* pMaxRange) const;

參數

pMinRange
COleDateTime物件或CTime物件指標，包含對象中CDateTimeCtrl允許的最早時間。

pMaxRange
COleDateTime物件或CTime物件指標，包含對象中CDateTimeCtrl允許的最近時間。

傳回值

值 DWORD ，其中包含指出要設定哪些範圍的旗標。如果

return value & GDTR_MAX == 0

則第二個參數有效。同樣地，如果

return value & GDTR_MIN == 0

則第一個參數有效。

備註

此成員函式會實作 Win32 訊息 DTM_GETRANGE 的行為，如 Windows SDK 中所述。在 MFC 的實作中，您可以指定 COleDateTime 或 CTime 用法。

範例

// This function will set several ranges in the control, then
// call the ShowRange() function to show the set ranges to the
// user.
void CDateTimeDlg::OnBnClickedRangesbutton()
{
   // Set minimum of January 1st, 1995 with no maximum.
   COleDateTime dtMin;
   COleDateTime dtMax;

   dtMin = COleDateTime(1995, 1, 1, 0, 0, 0);
   dtMax.SetStatus(COleDateTime::null);
   m_DateTimeCtrl.SetRange(&dtMin, &dtMax);
   ShowRange(&m_DateTimeCtrl);

   // Set no minimum and maximum of September 30th, 1997.
   dtMin.SetStatus(COleDateTime::null);
   dtMax = COleDateTime(1997, 9, 30, 0, 0, 0);
   m_DateTimeCtrl.SetRange(&dtMin, &dtMax);
   ShowRange(&m_DateTimeCtrl);

   // Set minimum of April 15, 1992 and maximum of June 5, 2002.
   dtMin = COleDateTime(1992, 4, 15, 0, 0, 0);
   dtMax = COleDateTime(2002, 6, 5, 0, 0, 0);
   m_DateTimeCtrl.SetRange(&dtMin, &dtMax);
   ShowRange(&m_DateTimeCtrl);
}

void CDateTimeDlg::ShowRange(CDateTimeCtrl *pCtrl)
{
   ASSERT(pCtrl != NULL);
   CString strMessage;
   COleDateTime dtMinimum;
   COleDateTime dtMaximum;

   // Get the range.
   DWORD dwResult = pCtrl->GetRange(&dtMinimum, &dtMaximum);

   // If a minimum was specified, format it.
   // Otherwise, indicate that there is no lower bound.
   if (dwResult & GDTR_MIN)
      strMessage += dtMinimum.Format(_T("Minimum range is %x %X.\r\n"));
   else
      strMessage += _T("No minimum range.\r\n");

   // Treat maximum similarly.
   if (dwResult & GDTR_MAX)
      strMessage += dtMaximum.Format(_T("Maximum range is %x %X.\r\n"));
   else
      strMessage += _T("No maximum range.\r\n");

   // Show the user.
   AfxMessageBox(strMessage);
}

`CDateTimeCtrl::GetTime`

從日期和時間選擇器控件擷取目前選取的時間，並將其放入指定的 SYSTEMTIME 結構中。

BOOL GetTime(COleDateTime& timeDest) const;
DWORD GetTime(CTime& timeDest) const;
DWORD GetTime(LPSYSTEMTIME pTimeDest) const;

參數

timeDest
在第一個 COleDateTime 版本中，將接收系統時間信息的對象參考。在第二個 CTime 版本中，將接收系統時間信息的對象參考。

pTimeDest
要接收系統時間信息的結構的指標 SYSTEMTIME 。必須不是 NULL。

傳回值

在第一個版本中，如果時間成功寫入物件，則為非零; COleDateTime 否則為 0。在第二個和第三個 DWORD 版本中，值等於 dwFlag 結構中 NMDATETIMECHANGE 設定的成員。 如需詳細資訊，請參閱下方的一節。

備註

此成員函式會實作 Win32 訊息 DTM_GETSYSTEMTIME 的行為，如 Windows SDK 中所述。在的 GetTimeMFC 實作中，您可以使用 COleDateTime 或 CTime 類別，或使用 SYSTEMTIME 結構來儲存時間資訊。

上述第二個和第三個版本的傳回值DWORD會指出日期和時間選擇器控件是否設定為「無日期」狀態，如結構成員dwFlags所示NMDATETIMECHANGE。如果傳回的值等於 GDT_NONE，控件會設定為「沒有日期」狀態，並使用 DTS_SHOWNONE 樣式。如果傳回的值等於 GDT_VALID，系統時間就會成功儲存在目的地位置。

範例

void CDateTimeDlg::OnBnClickedTimebutton()
{
   // get as a CTime
   CTime timeTime;
   DWORD dwResult = m_DateTimeCtrl.GetTime(timeTime);
   if (dwResult == GDT_VALID)
   {
      // the user checked the box and specified data
      CString str;

      // is it a time-only control, or a date-only control?
      if ((m_DateTimeCtrl.GetStyle() & DTS_TIMEFORMAT) == DTS_TIMEFORMAT)
         str = timeTime.Format(_T("%X"));
      else
         str = timeTime.Format(_T("%x"));
      AfxMessageBox(str);
   }
   else
   {
      // the user unmarked the "none" box
      AfxMessageBox(_T("Time not set!"));
   }

   // Calling as SYSTIME is much the same, but calling for a COleDateTime
   // has us test the state of the COleDateTime object for validity to
   // see if the user did or didn't check the "none" box.
}

`CDateTimeCtrl::GetIdealSize`

傳回顯示目前日期或時間所需之日期和時間選擇器控件的理想大小。

BOOL GetIdealSize(LPSIZE psize) const;

參數

psize
[out]結構指標 SIZE ，其中包含控件的理想大小。

傳回值

傳回值一律 TRUE為。

備註

這個方法會傳送 DTM_GETIDEALSIZE 訊息，如 Windows SDK 中所述。

範例

第一個程式代碼範例會定義變數，該變數 m_dateTimeCtrl用來以程式設計方式存取日期和時間選擇器控件。下一個範例中會使用此變數。

// Variable to access date-time control.
CDateTimeCtrl m_dateTimeCtrl;
// Variable to access the splitbutton control
CSplitButton m_splitbutton;

下一個程式代碼範例會擷取理想的大小，以顯示日期和時間選擇器控件。

// Add extra initialization here

// Associate a menu with the splitbutton control.
m_splitbutton.SetDropDownMenu(IDR_MENU1, 0);

// Resize the date-time picker control.
SIZE sz;
m_dateTimeCtrl.GetIdealSize(&sz);
if ((sz.cx != 0) && (sz.cy != 0))
{
   m_dateTimeCtrl.SetWindowPos(
       this,
       0, 0, sz.cx, sz.cy,
       (SWP_NOMOVE | SWP_NOZORDER | SWP_NOREPOSITION | SWP_NOACTIVATE));
}

// End of extra initialization

`CDateTimeCtrl::SetFormat`

根據指定的格式字串，設定日期和時間選擇器控件的顯示。

BOOL SetFormat(LPCTSTR pstrFormat);

參數

pstrFormat
定義所需顯示之零終止格式字串的指標。將此參數設定為 NULL 會將控件重設為目前樣式的預設格式字串。

傳回值

如果成功則為非零；否則為 0。

注意

使用者輸入不會判斷此呼叫的成功或失敗。

備註

此成員函式會實作 Win32 訊息 DTM_SETFORMAT 的行為，如 Windows SDK 中所述。

範例

// The control will create itself with a format that matches the
// locale setting in Control Panel. But we can force a particular
// format with a call to SetFormat(). This call forces the format
// dd-MMM-yy, which would show 03-APR-98 for April 3rd, 1998.
m_DateTimeCtrl.SetFormat(_T("dd-MMM-yy"));

`CDateTimeCtrl::SetMonthCalColor`

設定日期和時間選擇器控件內月曆指定部分的色彩。

COLORREF SetMonthCalColor(
    int iColor,
    COLORREF ref);

參數

iColor
int 值，指定要設定的月曆控件區域。此值可以是下列其中一項。

值	意義
`MCSC_BACKGROUND`	設定月份之間顯示的背景色彩。
`MCSC_MONTHBK`	設定在一個月內顯示的背景色彩。
`MCSC_TEXT`	設定用來在月份內顯示文字的色彩。
`MCSC_TITLEBK`	設定行事曆標題中顯示的背景色彩。
`MCSC_TITLETEXT`	設定用來在行事曆標題內顯示文字的色彩。
`MCSC_TRAILINGTEXT`	設定用來顯示頁首和尾端文字的色彩。標頭和尾端天數是出現在目前行事曆上之前個和後續月份的天數。

ref
值 COLORREF ，表示將針對月曆指定區域設定的色彩。

傳回值

COLORREF值，表示如果成功，則表示月曆控件指定部分的上一個色彩設定。否則，訊息會傳回 -1。

備註

此成員函式會實作 Win32 訊息 DTM_SETMCCOLOR 的行為，如 Windows SDK 中所述。

範例

請參閱 CDateTimeCtrl：：GetMonthCalColor 的範例。

`CDateTimeCtrl::SetMonthCalFont`

設定日期和時間選擇器控件子月曆控件將使用的字型。

void SetMonthCalFont(
    HFONT hFont,
    BOOL bRedraw = TRUE);

參數

hFont
要設定之字型的句柄。

bRedraw
指定設定字型時，是否應該立即重新繪製控件。將此參數設定為 TRUE 可讓控件重新繪製本身。

備註

此成員函式會實作 Win32 訊息 DTM_SETMCFONT 的行為，如 Windows SDK 中所述。

範例

// The following code example would most likely appear
// in the OnInitDialog function of your dialog class.
// It creates a font (Arial, 10 pixels high) and if successful,
// stores the result in m_MonthFont, a member of your
// dialog class declared as follows:
//    CFont m_MonthFont;
// SetMonthCalFont is then called passing in the new font,
// causing the month calendar control to display all
// text and dates with an Arial font.

//initializing the necessary members of the LOGFONT
// structure

LOGFONT lf;
memset(&lf, 0, sizeof(lf));
lf.lfHeight = 10;
_tcscpy_s(lf.lfFaceName, LF_FACESIZE, _T("Arial"));

if (m_MonthFont.CreateFontIndirect(&lf))
{
   // if successful, set the month calendar font
   m_DateTimeCtrl.SetMonthCalFont((HFONT)m_MonthFont);
}

注意

如果您使用此程式代碼，您會想要將衍生類別的成員 CDialog設為類型 為 m_MonthFont 的成員 CFont。

`CDateTimeCtrl::SetMonthCalStyle`

設定與目前日期和時間選擇器控件相關聯的下拉式月曆控件樣式。

DWORD SetMonthCalStyle(DWORD dwStyle);

參數

dwStyle
[in]新的月曆控件樣式，這是月曆控件樣式的位組合（OR）。如需詳細資訊，請參閱月曆控件樣式。

傳回值

下拉式月曆控件的上一個樣式。

備註

這個方法會傳送 DTM_SETMCSTYLE 訊息，如 Windows SDK 中所述。

範例

第一個程式代碼範例會定義變數，該變數 m_dateTimeCtrl用來以程式設計方式存取日期和時間選擇器控件。下一個範例中會使用此變數。

// Variable to access date-time control.
CDateTimeCtrl m_dateTimeCtrl;
// Variable to access the splitbutton control
CSplitButton m_splitbutton;

下一個程式代碼範例會設定日期和時間選擇器控件，以顯示周數、星期幾的縮寫名稱，以及沒有今天指標。

// Set the style of the month-calendar control dropdown.
void CCDateTimeCtrl_s1Dlg::OnSetmonthcalstyleWeeknumber()
{
   m_dateTimeCtrl.SetMonthCalStyle(MCS_WEEKNUMBERS);
}

void CCDateTimeCtrl_s1Dlg::OnSetmonthcalstyleNotoday()
{
   m_dateTimeCtrl.SetMonthCalStyle(MCS_NOTODAY);
}

void CCDateTimeCtrl_s1Dlg::OnSetmonthcalstyleShortdaysofweek()
{
   m_dateTimeCtrl.SetMonthCalStyle(MCS_SHORTDAYSOFWEEK);
}

`CDateTimeCtrl::SetRange`

設定日期和時間選擇器控件的最小和允許系統時間上限。

BOOL SetRange(
    const COleDateTime* pMinRange,
    const COleDateTime* pMaxRange);

BOOL SetRange(
    const CTime* pMinRange,
    const CTime* pMaxRange);

參數

pMinRange
COleDateTime物件或CTime物件指標，包含對象中CDateTimeCtrl允許的最早時間。

pMaxRange
COleDateTime物件或CTime物件指標，包含對象中CDateTimeCtrl允許的最近時間。

傳回值

如果成功則為非零；否則為 0。

備註

此成員函式會實作 Win32 訊息 DTM_SETRANGE 的行為，如 Windows SDK 中所述。在 MFC 的實作中，您可以指定 COleDateTime 或 CTime 用法。 COleDateTime如果物件具有NULL狀態，則會移除範圍。 CTime如果指標或COleDateTime指標為 NULL，則會移除範圍。

範例

請參閱 CDateTimeCtrl::GetRange 的範例。

`CDateTimeCtrl::SetTime`

設定日期和時間選擇器控件中的時間。

BOOL SetTime(const COleDateTime& timeNew);
BOOL SetTime(const CTime* pTimeNew);
BOOL SetTime(LPSYSTEMTIME pTimeNew = NULL);

參數

timeNew
物件的參考 COleDateTime ，包含控制項將設定的目標。

pTimeNew
在上述第二個版本中，物件的指標 CTime ，其中包含控件將設定的時間。在上述第三個版本中，結構的指標 SYSTEMTIME ，其中包含控件將設定的時間。

傳回值

如果成功則為非零；否則為 0。

備註

此成員函式會實作 Win32 訊息 DTM_SETSYSTEMTIME 的行為，如 Windows SDK 中所述。在的 SetTimeMFC 實作中，您可以使用 COleDateTime 或 CTime 類別，或使用 SYSTEMTIME 結構來設定時間資訊。

範例

// set with a CTime
CTime timeTime(1998, 4, 3, 0, 0, 0);
VERIFY(m_DateTimeCtrl.SetTime(&timeTime));

// set with a COleDateTime object
COleDateTime oletimeTime(1998, 4, 3, 0, 0, 0);
VERIFY(m_DateTimeCtrl.SetTime(oletimeTime));

// set using the SYSTEMTIME
SYSTEMTIME sysTime;
memset(&sysTime, 0, sizeof(sysTime));
sysTime.wYear = 1998;
sysTime.wMonth = 4;
sysTime.wDay = 3;
VERIFY(m_DateTimeCtrl.SetTime(&sysTime));

另請參閱

MFC 範例 CMNCTRL1
CWnd 類
 階層架構圖表
 CMonthCalCtrl 類

共用方式為

CDateTimeCtrl 類別

語法

成員

公用建構函式

公用方法

備註

繼承階層架構

需求

CDateTimeCtrl::CDateTimeCtrl

CDateTimeCtrl::CloseMonthCal

備註

範例

CDateTimeCtrl::Create

參數

傳回值

備註

建立日期和時間選擇器控制件

範例

CDateTimeCtrl::GetDateTimePickerInfo

參數

傳回值

備註

範例

CDateTimeCtrl::GetMonthCalColor

參數

傳回值

備註

範例

CDateTimeCtrl::GetMonthCalCtrl

傳回值

備註

範例

CDateTimeCtrl::GetMonthCalFont

傳回值

備註

CDateTimeCtrl::GetMonthCalStyle

傳回值

備註

CDateTimeCtrl::GetRange

參數

傳回值

備註

範例

CDateTimeCtrl::GetTime

參數

傳回值

備註

範例

CDateTimeCtrl::GetIdealSize

參數

傳回值

備註

範例

CDateTimeCtrl::SetFormat

參數

傳回值

備註

範例

CDateTimeCtrl::SetMonthCalColor

參數

傳回值

備註

範例

CDateTimeCtrl::SetMonthCalFont

參數

備註

範例

CDateTimeCtrl::SetMonthCalStyle

參數

傳回值

備註

範例

CDateTimeCtrl::SetRange

參數

傳回值

備註

範例

CDateTimeCtrl::SetTime

參數

`CDateTimeCtrl` 類別

`CDateTimeCtrl::CDateTimeCtrl`

`CDateTimeCtrl::CloseMonthCal`

`CDateTimeCtrl::Create`

`CDateTimeCtrl::GetDateTimePickerInfo`

`CDateTimeCtrl::GetMonthCalColor`

`CDateTimeCtrl::GetMonthCalCtrl`

`CDateTimeCtrl::GetMonthCalFont`

`CDateTimeCtrl::GetMonthCalStyle`

`CDateTimeCtrl::GetRange`

`CDateTimeCtrl::GetTime`

`CDateTimeCtrl::GetIdealSize`

`CDateTimeCtrl::SetFormat`

`CDateTimeCtrl::SetMonthCalColor`

`CDateTimeCtrl::SetMonthCalFont`

`CDateTimeCtrl::SetMonthCalStyle`

`CDateTimeCtrl::SetRange`

`CDateTimeCtrl::SetTime`