CMonthCalCtrl::GetRange

Ruft die laufenden minimale und maximale Datum ab, die in einem Monatskalender-Steuerelement festgelegt werden.

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

Parameter

• pMinRange
  Ein Zeiger auf ein Objekt, COleDateTime zu einem CTime-Objekt oder einem SYSTEMTIME-Struktur, die das Datum am untersten Ende des Bereichs enthält.

• pMaxRange
  Ein Zeiger auf ein Objekt, COleDateTime zu einem CTime-Objekt oder einem SYSTEMTIME-Struktur, die das Datum am leistungsfähigsten des Bereichs enthält.

Rückgabewert

DWORD, das null sein kann (keine Grenzen werden festgelegt) oder eine Kombination der folgenden Werte, die Grenzeninformationen angeben.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Meldung MCM_GETRANGE, wie in Windows SDK beschrieben.In MFC Implementierung von GetRange, können Sie eine COleDateTime Verwendung, eine CTime Verwendung oder eine SYSTEMTIME-Strukturverwendung angeben.

Beispiel

// This code fragment sets a variety of ranges in the
// control, and calls a separate function to show the
// set range to the user.

void CMonthCalDlg::OnBnClickedRangebutton()
{
   // 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_calCtrl1.SetRange(&dtMin, &dtMax);
   ShowRange(&m_calCtrl1);

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

   // 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_calCtrl1.SetRange(&dtMin, &dtMax);
   ShowRange(&m_calCtrl1);
}

void CMonthCalDlg::ShowRange(CMonthCalCtrl* pMoCalCtrl)
{
   ASSERT(pMoCalCtrl != NULL);
   CString strMessage;
   COleDateTime dtMinimum;
   COleDateTime dtMaximum;

   // Get the range
   DWORD dwResult = pMoCalCtrl->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);
}

Anforderungen

Header: afxdtctl.h

Siehe auch

Referenz

CMonthCalCtrl-Klasse

Hierarchien-Diagramm

CMonthCalCtrl::SetRange