<?xml version="1.0"?>
<doc>
<assembly>
<name>System.Windows.Controls</name>
</assembly>
<members>
<member name="T:System.Windows.Controls.Calendar">
<summary>
Represents a control that enables a user to select a date by using a
visual calendar display.
</summary>
<remarks>
<para>
A Calendar control can be used on its own, or as a drop-down part of a
DatePicker control. For more information, see DatePicker. A Calendar
displays either the days of a month, the months of a year, or the years
of a decade, depending on the value of the DisplayMode property. When
displaying the days of a month, the user can select a date, a range of
dates, or multiple ranges of dates. The kinds of selections that are
allowed are controlled by the SelectionMode property.
</para>
<para>
The range of dates displayed is governed by the DisplayDateStart and
DisplayDateEnd properties. If DisplayMode is Year or Decade, only
months or years that contain displayable dates will be displayed.
Setting the displayable range to a range that does not include the
current DisplayDate will throw an ArgumentOutOfRangeException.
</para>
<para>
The BlackoutDates property can be used to specify dates that cannot be
selected. These dates will be displayed as dimmed and disabled.
</para>
<para>
By default, Today is highlighted. This can be disabled by setting
IsTodayHighlighted to false.
</para>
<para>
The Calendar control provides basic navigation using either the mouse or
keyboard. The following table summarizes keyboard navigation.
Key Combination DisplayMode Action
ARROW Any Change focused date, unselect
all selected dates, and select
new focused date.
SHIFT+ARROW Any If SelectionMode is not set to
SingleDate or None begin
selecting a range of dates.
CTRL+UP ARROW Any Switch to the next larger
DisplayMode. If DisplayMode is
already Decade, no action.
CTRL+DOWN ARROW Any Switch to the next smaller
DisplayMode. If DisplayMode is
already Month, no action.
SPACEBAR Month Select focused date.
SPACEBAR Year or Decade Switch DisplayMode to the Month
or Year represented by focused
item.
</para>
<para>
XAML Usage for Classes Derived from Calendar
If you define a class that derives from Calendar, the class can be used
as an object element in XAML, and all of the inherited properties and
events that show a XAML usage in the reference for the Calendar members
can have the same XAML usage for the derived class. However, the object
element itself must have a different prefix mapping than the controls:
mapping shown in the usages, because the derived class comes from an
assembly and namespace that you create and define. You must define your
own prefix mapping to an XML namespace to use the class as an object
element in XAML.
</para>
</remarks>
<QualityBand>Mature</QualityBand>
</member>
<member name="F:System.Windows.Controls.Calendar.RowsPerMonth">
<summary>
Inherited code: Requires comment.
</summary>
</member>
<member name="F:System.Windows.Controls.Calendar.ColumnsPerMonth">
<summary>
Inherited code: Requires comment.
</summary>
</member>
<member name="F:System.Windows.Controls.Calendar.RowsPerYear">
<summary>
Inherited code: Requires comment.
</summary>
</member>
<member name="F:System.Windows.Controls.Calendar.ColumnsPerYear">
<summary>
Inherited code: Requires comment.
</summary>
</member>
<member name="F:System.Windows.Controls.Calendar.ElementRoot">
<summary>
Inherited code: Requires comment.
</summary>
</member>
<member name="F:System.Windows.Controls.Calendar.ElementMonth">
<summary>
Inherited code: Requires comment.
</summary>
</member>
<member name="F:System.Windows.Controls.Calendar.CalendarButtonStyleProperty">
<summary>
Identifies the CalendarButtonStyle dependency property.
</summary>
</member>
<member name="M:System.Windows.Controls.Calendar.OnCalendarButtonStyleChanged(System.Windows.DependencyObject,System.Windows.DependencyPropertyChangedEventArgs)">
<summary>
Inherited code: Requires comment.
</summary>
<param name="d">Inherited code: Requires comment 1.</param>
<param name="e">Inherited code: Requires comment 2.</param>
</member>
<member name="M:System.Windows.Controls.Calendar.EnsureCalendarButtonStyle(System.Windows.Controls.Primitives.CalendarButton,System.Windows.Style,System.Windows.Style)">
<summary>
Inherited code: Requires comment.
</summary>
<param name="calendarButton">Inherited code: Requires comment 1.</param>
<param name="oldCalendarButtonStyle">Inherited code: Requires comment 2.</param>
<param name="newCalendarButtonStyle">Inherited code: Requires comment 3.</param>
</member>
<member name="F:System.Windows.Controls.Calendar.CalendarDayButtonStyleProperty">
<summary>
Identifies the DayButtonStyle dependency property.
</summary>
</member>
<member name="M:System.Windows.Controls.Calendar.OnCalendarDayButtonStyleChanged(System.Windows.DependencyObject,System.Windows.DependencyPropertyChangedEventArgs)">
<summary>
Inherited code: Requires comment.
</summary>
<param name="d">Inherited code: Requires comment 1.</param>
<param name="e">Inherited code: Requires comment 2.</param>
</member>
<member name="M:System.Windows.Controls.Calendar.EnsureDayButtonStyle(System.Windows.Controls.Primitives.CalendarDayButton,System.Windows.Style,System.Windows.Style)">
<summary>
Inherited code: Requires comment.
</summary>
<param name="dayButton">Inherited code: Requires comment 1.</param>
<param name="oldDayButtonStyle">Inherited code: Requires comment 2.</param>
<param name="newDayButtonStyle">Inherited code: Requires comment 3.</param>
</member>