Calendar.DisplayDateStart Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the first date that is available in the calendar.
public:
property Nullable<DateTime> DisplayDateStart { Nullable<DateTime> get(); void set(Nullable<DateTime> value); };
public DateTime? DisplayDateStart { get; set; }
member this.DisplayDateStart : Nullable<DateTime> with get, set
Public Property DisplayDateStart As Nullable(Of DateTime)
Property Value
The first date that is available in the calendar. The default is null
.
Examples
The following code sets up a Calendar with a particular range of displayable dates, and sets the currently selected and displayed date.
// Create a Calendar that displays 1/10/2009
// through 4/18/2009.
Calendar basicCalendar = new Calendar();
basicCalendar.DisplayDateStart = new DateTime(2009, 1, 10);
basicCalendar.DisplayDateEnd = new DateTime(2009, 4, 18);
basicCalendar.DisplayDate = new DateTime(2009, 3, 15);
basicCalendar.SelectedDate = new DateTime(2009, 2, 15);
// root is a Panel that is defined elswhere.
root.Children.Add(basicCalendar);
' Create a Calendar that displays 1/10/2009
' through 4/18/2009.
Dim basicCalendar As New Calendar()
basicCalendar.DisplayDateStart = New DateTime(2009, 1, 10)
basicCalendar.DisplayDateEnd = New DateTime(2009, 4, 18)
basicCalendar.DisplayDate = New DateTime(2009, 3, 15)
basicCalendar.SelectedDate = New DateTime(2009, 2, 15)
' root is a Panel that is defined elswhere.
root.Children.Add(basicCalendar)
<!-- Create a Calendar that displays 1/10/2009
through 4/18/2009. -->
<Calendar Margin="20"
SelectedDate="2/15/2009"
DisplayDate="3/15/2009"
DisplayDateStart="1/10/2009"
DisplayDateEnd="4/18/2009"/>
Remarks
You can restrict the range of a Calendar by setting the DisplayDateStart and DisplayDateEnd properties. A user cannot scroll to or select dates outside of this range. If you set the SelectedDate property to a date that is before DisplayDateStart, DisplayDateStart is set to the same value as SelectedDate.
Dependency Property Information
Item | Value |
---|---|
Identifier field | DisplayDateStartProperty |
Metadata properties set to true |
BindsTwoWayByDefault |
XAML Attribute Usage
<Calendar DisplayDateStart="dateTimeString"/>
XAML Values
dateTimeString A date that is in one of the formats that are listed in the DateTime XAML Syntax topic.