DateTimePicker.CalendarMonthBackground Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets the background color of the calendar month.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public Color CalendarMonthBackground { get; set; }

Property Value

Type: System.Drawing.Color

A Color that represents the background color of the calendar month.

Exception Condition
ArgumentException

The value assigned is null.

When a DateTimePicker is created, this property is initially set equal to the DefaultMonthBackColor field value.

Starting with Windows Vista and depending on the theme, setting this property might not change the appearance of the calendar. For example, if Windows is set to use the Aero theme, setting this property has no effect. This is because an updated version of the calendar is rendered with an appearance that is derived at run time from the current operating system theme. If you want to use this property and enable the earlier version of the calendar, you can disable visual styles for your application. Disabling visual styles might affect the appearance and behavior of other controls in your application. To disable visual styles in Visual Basic, open the Project Designer and uncheck the Enable XP visual styles check box. To disable visual styles in C#, open Program.cs and comment out Application.EnableVisualStyles();.

The following code example demonstrates how to initialize the CalendarMonthBackground property. After creating a DateTimePicker and adding it to a Form, the example initializes the CalendarMonthBackground property to a Color constant.

public MyClass()
{
   DateTimePicker dateTimePicker1 = new DateTimePicker();
   Controls.AddRange(new Control[] {dateTimePicker1}); 
   dateTimePicker1.CalendarMonthBackground = Color.Aqua;
}

.NET Framework
Available since 1.1
Return to top
Show: