All docs
V20.1
20.1
19.2
19.1
The page you are viewing does not exist in version 19.1. This link will take you to the root page.
18.2
The page you are viewing does not exist in version 18.2. This link will take you to the root page.
18.1
The page you are viewing does not exist in version 18.1. This link will take you to the root page.
17.2
The page you are viewing does not exist in version 17.2. This link will take you to the root page.

Date Navigator

  • 2 minutes to read

The DateNavigator control allows users to select a date or a range of dates to display in the Scheduler.

The image below shows the elements of the DateNavigator.

DateNavigator

Add the Date Navigator

The DateNavigator is a standalone control. To use it with the Scheduler, add the DateNavigator to your application and use the SchedulerDateNavigatorStyleSettings.Scheduler property to bind it to the SchedulerControl. See the example below.

    xmlns:dxe="http://schemas.devexpress.com/winfx/2008/xaml/editors"
    xmlns:dxsch="http://schemas.devexpress.com/winfx/2008/xaml/scheduling"
<!---->
 <Grid>
    <Grid.ColumnDefinitions>
        <ColumnDefinition Width="*" />
        <ColumnDefinition Width="Auto" />
    </Grid.ColumnDefinitions>
    <dxsch:SchedulerControl x:Name="scheduler" />
    <dxe:DateNavigator x:Name="datenavigator" 
        Grid.Column="1" 
        VerticalAlignment="Stretch">
        <dxe:DateNavigator.StyleSettings>
            <dxsch:SchedulerDateNavigatorStyleSettings Scheduler="{Binding ElementName=scheduler}" />
        </dxe:DateNavigator.StyleSettings>
    </dxe:DateNavigator>
</Grid>

Refer to the How to: Create the Scheduler with the DateNavigator for a step-by-step tutorial.

Customize the Date Navigator

Display Settings

The table below lists the properties that affect the DateNavigator appearance.

Characteristics

Properties

Today button visibility

DateNavigator.ShowTodayButton

Number of rows and columns

DateNavigator.ColumnCount

DateNavigator.RowCount

First day of the week

DateNavigator.FirstDayOfWeek

Holidays

DateNavigator.Holidays

DateNavigator.HighlightHolidays

Workdays

DateNavigator.Workdays

DateNavigator.ExactWorkdays

Special dates

DateNavigator.SpecialDates

DateNavigator.HighlightSpecialDates

Week numbers

DateNavigator.ShowWeekNumbers

Behavior Settings

The table below lists the properties that affect the DateNavigator behavior. Use the DateNavigator.StyleSettings property to specify the SchedulerDateNavigatorStyleSettings.

Characteristics

Properties

Dates users can select

DateNavigator.DisabledDates

SchedulerControl.LimitInterval

DateNavigator.MaxValue

DateNavigator.MinValue

Multiple date selection

DateNavigator.IsMultiSelect

Multiple date range selection

DateNavigator.AllowMultipleRanges (requires the DateNavigator.IsMultiSelect option)

The maximum number of dates users can select simultaneously

DateNavigator.MaxSelectionLength

Change the scheduler view based on the selection

SchedulerDateNavigatorStyleSettings.AllowChangeSchedulerView

Update the month part of the selected dates when the user navigates through different months

SchedulerDateNavigatorStyleSettings.AllowUpdateSelectionOnMonthChanged

The maximum number of consecutively selected weeks

SchedulerDateNavigatorStyleSettings.MaxSelectedConsecutiveWeeks

The maximum number of individually selected dates

SchedulerDateNavigatorStyleSettings.MaxSelectedNonConsecutiveDates

See Also