Edit

Share via


Calendar.DisplayDateStart Property

Definition

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.

Applies to

See also