MonthCal_GetMinReqRect macro (commctrl.h)

Article
2024-10-23

Retrieves the minimum size required to display a full month in a month calendar control. Size information is presented in the form of a RECT structure. You can use this macro or send the MCM_GETMINREQRECT message explicitly.

Syntax

BOOL MonthCal_GetMinReqRect(
   HWND   hmc,
   LPRECT prc
);

Parameters

hmc

Type: HWND

Handle to a month calendar control.

prc

Type: LPRECT

Pointer to a RECT structure that will receive bounding rectangle information. This parameter must be a valid address and cannot be NULL.

Return value

Type: BOOL

Returns nonzero and MonthCal_GetMinReqRect receives the applicable bounding information if successful. Otherwise, the return is zero.

Remarks

The minimum required window size for a month calendar control depends on the currently selected font, control styles, system metrics, and regional settings. When an application changes anything that affects the minimum window size, or processes a WM_SETTINGCHANGE message, it should call MonthCal_GetMinReqRect to determine the new minimum size.

Note The rectangle returned by MonthCal_GetMinReqRect does not include the width of the "Today" string, if it is present. If the MCS_NOTODAY style is not set, your application should also retrieve the rectangle that defines the "Today" string width by calling the MonthCal_GetMaxTodayWidth macro. Use the larger of the two rectangles to ensure that the "Today" string is not clipped.

The top and left members of prc will always be zero. The right and bottom members represent the minimum cx and cy required for the control.

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

Share via