Поделиться через


Класс CDateTimeCtrl

Инкапсулирует функциональность элемента управления "выбор даты и времени".

Синтаксис

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) предоставляет простой интерфейс для обмена сведениями о дате и времени с пользователем. Этот интерфейс содержит поля, каждый из которых отображает часть сведений о дате и времени, хранящихся в элементе управления. Пользователь может изменить сведения, хранящиеся в элементе управления, изменив содержимое строки в заданном поле. Пользователь может перемещаться из поля в поле с помощью мыши или клавиатуры.

Элемент управления выбора даты и времени можно настроить, применяя различные стили к объекту при его создании. Дополнительные сведения о стилях элементов выбора даты и времени см. в пакете SDK для Windows, чтобы получить дополнительные сведения о стилях, относящихся к элементу управления "Выбор даты и времени". Вы можете задать формат отображения элемента управления DTP с помощью стилей форматирования. Эти стили форматирования описаны в разделе "Стили форматирования" в разделе "Стили элементов управления выбора времени и даты и времени" пакета SDK для Windows.

Элемент управления выбора даты и времени также использует уведомления и обратные вызовы, описанные в разделе Using CDateTimeCtrl.

Иерархия наследования

CObject

CCmdTarget

CWnd

CDateTimeCtrl

Требования

Заголовок: afxdtctl.h

CDateTimeCtrl::CDateTimeCtrl

Формирует объект CDateTimeCtrl.

CDateTimeCtrl();

CDateTimeCtrl::CloseMonthCal

Закрывает текущий элемент управления выбора даты и времени.

void CloseMonthCal() const;

Замечания

Этот метод отправляет DTM_CLOSEMONTHCAL сообщение, описанное в пакете SDK для Windows.

Пример

Первый пример кода определяет переменную, 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
Задает сочетание стилей элементов управления даты и времени. Дополнительные сведения о стилях элементов выбора даты и времени см. в пакете SDK для Windows.

rect
Ссылка на RECT структуру, которая является позицией и размером элемента управления выбора даты и времени.

pParentWnd
Указатель на CWnd объект, который является родительским окном элемента управления выбора даты и времени. Это не должно быть NULL.

nID
Указывает идентификатор элемента управления выбора даты и времени.

Возвращаемое значение

Ненулевое значение, если создание выполнено успешно; в противном случае — 0.

Замечания

Создание элемента управления выбора даты и времени
  1. Вызов для CDateTimeCtrl создания CDateTimeCtrl объекта.

  2. Вызовите эту функцию-член, которая создает элемент управления выбора даты и времени 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 сообщение, описанное в пакете SDK для Windows.

Пример

Первый пример кода определяет переменную, 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 область календаря месяца требуется извлечь. Список значений см. в SetMonthCalColorпараметре iColor .

Возвращаемое значение

Значение COLORREF , представляющее параметр цвета для указанной части элемента управления календаря месяца в случае успешного выполнения. Функция возвращает значение -1 в случае неудачного выполнения.

Замечания

Эта функция-член реализует поведение сообщения DTM_GETMCCOLORWin32, как описано в пакете SDK для Windows.

Пример

// 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;

Возвращаемое значение

Стиль раскрывающегося элемента управления календаря месяца, который представляет собой побитовое сочетание стилей элементов управления выбора даты и времени. Дополнительные сведения см. в разделе "Стили элементов управления календарем месяца".

Замечания

Этот метод отправляет DTM_GETMCSTYLE сообщение, описанное в пакете SDK для Windows.

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

затем первый параметр действителен.

Замечания

Эта функция-член реализует поведение сообщения DTM_GETRANGEWin32, как описано в пакете SDK для Windows. В реализации 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 элементов в структуре. Дополнительные сведения см. в разделе "Примечания" ниже.

Замечания

Эта функция-член реализует поведение сообщения DTM_GETSYSTEMTIMEWin32, как описано в пакете SDK для Windows. В реализации GetTimeMFC можно использовать COleDateTime или классы или CTime использовать структуру SYSTEMTIME для хранения сведений о времени.

Возвращаемое значение DWORD во второй и третьей версиях выше указывает, задано ли элемент управления выбора даты и времени состояние "нет даты", как указано в элементе NMDATETIMECHANGE dwFlagsструктуры. Если возвращаемое значение равно 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 сообщение, описанное в пакете SDK для Windows.

Пример

Первый пример кода определяет переменную, 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.

Примечание.

Входные данные пользователя не определяют успешность или сбой для этого вызова.

Замечания

Эта функция-член реализует поведение сообщения DTM_SETFORMATWin32, как описано в пакете SDK для Windows.

Пример

// 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.

Замечания

Эта функция-член реализует поведение сообщения DTM_SETMCCOLORWin32, как описано в пакете SDK для Windows.

Пример

См. пример CDateTimeCtrl ::GetMonthCalColor.

CDateTimeCtrl::SetMonthCalFont

Задает шрифт, используемый элементом управления "Выбор даты и времени" дочернего календаря месяца.

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

Параметры

hFont
Дескриптор шрифта, который будет задан.

bRedraw
Указывает, следует ли перезапись элемента управления сразу после задания шрифта. При задании этого параметра TRUE элемент управления перерисовывается.

Замечания

Эта функция-член реализует поведение сообщения DTM_SETMCFONTWin32, как описано в пакете SDK для Windows.

Пример

// 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 сообщение, описанное в пакете SDK для Windows.

Пример

Первый пример кода определяет переменную, 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.

Замечания

Эта функция-член реализует поведение сообщения DTM_SETRANGEWin32, как описано в пакете SDK для Windows. В реализации 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.

Замечания

Эта функция-член реализует поведение сообщения DTM_SETSYSTEMTIMEWin32, как описано в пакете SDK для Windows. В реализации 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 Класс