`CDateTimeCtrl` 類別

發行項
10/12/2023

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

語法

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 ，其中包含指出要設定哪些範圍的旗標。 If

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 中所述。在的 GetTime MFC 實作中，您可以使用 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 中所述。在的 SetTime MFC 實作中，您可以使用 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`