DateTime_SetMonthCalColor macro (commctrl.h)

Article
10/23/2024

Sets the color for a given portion of the month calendar within a date and time picker (DTP) control. You can use this macro or send the DTM_SETMCCOLOR message explicitly.

Syntax

COLORREF DateTime_SetMonthCalColor(
   HWND     hdp,
   int      iColor,
   COLORREF clr
);

Parameters

hdp

Type: HWND

A handle to a DTP control.

iColor

Type: int

A value of type int specifying which month calendar color to set. This value can be one of the following:

Value	Meaning
MCSC_BACKGROUND	Set the background color displayed between months.
MCSC_MONTHBK	Set the background color displayed within the month.
MCSC_TEXT	Set the color used to display text within a month.
MCSC_TITLEBK	Set the background color displayed in the calendar's title.
MCSC_TITLETEXT	Set the color used to display text within the calendar's title.
MCSC_TRAILINGTEXT	Set the color used to display header day and trailing day text. Header and trailing days are the days from the previous and following months that appear on the current month calendar.

clr

Type: COLORREF

A COLORREF value that represents the color that will be set for the specified area of the month calendar.

Return value

Type: COLORREF

Returns a COLORREF value that represents the previous color setting for the specified portion of the month calendar control if successful. Otherwise, this message returns -1.

Remarks

When visual styles are enabled, this macro has no effect except when iColor is MCSC_BACKGROUND.

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