Andy De George
c0ba284473
* Merge winforms framework content to working branch (#14) * Breadcrumb / TOC / Move net5 to net folder (#15) * change path from net5 to net * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Add .net 5 winforms placeholder article (#16) * added some metadata and adjusted net5 placeholder * corrections * corrections * corrections * Test1 * Swapping landing page vs concept * fix links * Fix links * Fix desc
3.2 KiB
title, ms.date, f1_keywords, helpviewer_keywords, ms.assetid
| title | ms.date | f1_keywords | helpviewer_keywords | ms.assetid | ||||
|---|---|---|---|---|---|---|---|---|
| MonthCalendar Control Overview | 03/30/2017 |
|
|
788c5325-b721-44ec-95bf-9b680ba0f6a2 |
MonthCalendar Control Overview (Windows Forms)
The Windows Forms xref:System.Windows.Forms.MonthCalendar control presents an intuitive graphical interface for users to view and set date information. The control displays a calendar: a grid containing the numbered days of the month, arranged in columns underneath the days of the week, with the selected range of dates highlighted. You can select a different month by clicking the arrow buttons on either side of the month caption. Unlike the similar xref:System.Windows.Forms.DateTimePicker control, you can select more than one date with this control. For more information about the xref:System.Windows.Forms.DateTimePicker control, see DateTimePicker Control.
Configuring the MonthCalendar Control
The xref:System.Windows.Forms.MonthCalendar control's appearance is highly configurable. By default, today's date is displayed as circled, and is also noted at the bottom of the grid. You can change this feature by setting the xref:System.Windows.Forms.MonthCalendar.ShowToday%2A and xref:System.Windows.Forms.MonthCalendar.ShowTodayCircle%2A properties to false. You can also add week numbers to the calendar by setting the xref:System.Windows.Forms.MonthCalendar.ShowWeekNumbers%2A property to true. By setting the xref:System.Windows.Forms.MonthCalendar.CalendarDimensions%2A property, you can have multiple months displayed horizontally and vertically. By default, Sunday is shown as the first day of the week, but any day can be designated using the xref:System.Windows.Forms.MonthCalendar.FirstDayOfWeek%2A property.
You can also set certain dates to be displayed in bold on a one-time basis, annually, or monthly, by adding xref:System.DateTime objects to the xref:System.Windows.Forms.MonthCalendar.BoldedDates%2A, xref:System.Windows.Forms.MonthCalendar.AnnuallyBoldedDates%2A, and xref:System.Windows.Forms.MonthCalendar.MonthlyBoldedDates%2A properties. For more information, see How to: Display Specific Days in Bold with the Windows Forms MonthCalendar Control.
The key property of the xref:System.Windows.Forms.MonthCalendar control is xref:System.Windows.Forms.MonthCalendar.SelectionRange%2A, the range of dates selected in the control. The xref:System.Windows.Forms.MonthCalendar.SelectionRange%2A value cannot exceed the maximum number of days that can be selected, set in the xref:System.Windows.Forms.MonthCalendar.MaxSelectionCount%2A property. The earliest and latest dates the user can select are determined by the xref:System.Windows.Forms.MonthCalendar.MaxDate%2A and xref:System.Windows.Forms.MonthCalendar.MinDate%2A properties.