This topic has not yet been rated - Rate this topic

Calendar.DisplayMode Property

.NET Framework 4

Gets or sets a value that indicates whether the calendar displays a month, year, or decade.

Namespace: System.Windows.Controls
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

Syntax

C++

Copy

public CalendarMode DisplayMode { get; set; }

XAML Attribute Usage

Copy

<object DisplayMode="CalendarMode" .../>

Property Value

Type: System.Windows.Controls.CalendarMode
A value that indicates what length of time the Calendar should display.

Dependency Property Information

Identifier field	DisplayModeProperty
Metadata properties set to true	BindsTwoWayByDefault

Remarks

A Calendar can display a month, a year, or a decade. 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.

Examples

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.

Copy


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);

XAML

Copy


<Calendar DisplayMode="Year" DisplayModeChanged="Calendar_DisplayModeChanged" />

Copy


private void Calendar_DisplayModeChanged(object sender,
                                         CalendarModeChangedEventArgs e)
{
    Calendar calObj = sender as Calendar;

    calObj.DisplayMode = CalendarMode.Year;
}

Version Information

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Calendar Class

System.Windows.Controls Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ