MonthCal_GetMonthRange macro (commctrl.h)

Retrieves date information (using SYSTEMTIME structures) that represents the high and low limits of a month calendar control's display. You can use this macro or send the MCM_GETMONTHRANGE message explicitly.

Syntax

void MonthCal_GetMonthRange(
   hmc,
   gmr,
   rgst
);

Parameters

hmc

Type: HWND

Handle to a month calendar control.

gmr

Type: DWORD

Value specifying the scope of the range limits to be retrieved. This value must be one of the following:

Value Meaning
GMR_DAYSTATE
Include preceding and trailing months of visible range that are only partially displayed.
GMR_VISIBLE
Include only those months that are entirely displayed.

rgst

Type: LPSYSTEMTIME

Pointer to a two-element array of SYSTEMTIME structures that will receive the lower and upper limits of the scope specified by dwFlag. The lower and upper limits are placed in lprgSysTimeArray[0] and lprgSysTimeArray[1], respectively. The time members of these structures will not be modified. This parameter must be a valid address and cannot be NULL.

Return value

None

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header commctrl.h