MonthCal_SetMonthDelta macro (commctrl.h)

Sets the scroll rate for a month calendar control. The scroll rate is the number of months that the control moves its display when the user clicks a scroll button. You can use this macro or send the MCM_SETMONTHDELTA message explicitly.

Syntax

INT MonthCal_SetMonthDelta(
   HWND hmc,
   INT  n
);

Parameters

hmc

Type: HWND

Handle to a month calendar control.

n

Type: INT

Value representing the number of months to be set as the control's scroll rate. If this value is zero, the month delta is reset to the default, which is the number of months displayed in the control.

Return value

Type: INT

Returns an INT value that represents the previous scroll rate. If the scroll rate was not previously set, the return value is zero.

Remarks

The PAGE UP and PAGE DOWN keys, VK_PRIOR and VK_NEXT, change the selected month by one, regardless of the number of months displayed or the value set by MCM_SETMONTHDELTA.

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