Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CalendarMode Enumeration

 
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.

Specifies whether a Calendar displays a month, year, or decade.

Namespace:   System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

public enum CalendarMode

Member nameDescription
Decade

The Calendar displays a decade at a time.

Month

The Calendar displays a month at a time.

Year

The Calendar displays a year at a time.

A Calendar can display a month, a year, or a decade at a time. The following table lists how the user navigates to each mode.

DisplayMode

Action

Month

To navigate to Year mode, click the month heading.

Year

To navigate to Decade mode, click the year heading. To navigate to Month mode, click one of the displayed months.

Decade

To navigate to Year mode, click one of the displayed years.

The following example creates a calendar that displays the months in a year and handles the DisplayModeChanged event so that when the user clicks on a month or the year, the calendar does not change its DisplayMode.

Calendar yearCalendar = new Calendar();
yearCalendar.DisplayMode = CalendarMode.Year;
yearCalendar.DisplayModeChanged +=
    new EventHandler<CalendarModeChangedEventArgs>(Calendar_DisplayModeChanged);

// root is a Panel that is defined elswhere.
root.Children.Add(yearCalendar);
<Calendar DisplayMode="Year" DisplayModeChanged="Calendar_DisplayModeChanged" />
private void Calendar_DisplayModeChanged(object sender,
                                         CalendarModeChangedEventArgs e)
{
    Calendar calObj = sender as Calendar;

    calObj.DisplayMode = CalendarMode.Year;
}

.NET Framework
Available since 4.0
Silverlight
Available since 2.0
Return to top
Show:
© 2018 Microsoft