Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
  [Expand]Reporting
  [Expand]Chart Control
  [Expand]Grid View
  [Expand]Card View
  [Expand]Vertical Grid
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Image and Data Browsing
  [Expand]Docking and Popups
  [Expand]Site Navigation and Layout
  [Expand]File Management
  [Expand]Multi-Use Site Controls
  [Collapse]Scheduler
   [Expand]Product Information
    Getting Started
   [Expand]Fundamentals
   [Expand]Concepts
   [Collapse]Visual Elements
    [Expand]ASPxScheduler
     ASPxDateNavigator
   [Expand]Design-Time Features
   [Expand]Examples
   [Expand]End-User Capabilities
   [Expand]Member Tables
  [Expand]HTML Editor
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gauges
  [Expand]Data Editors
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

ASPxDateNavigator

This topic describes the ASPxDateNavigator control and its visual elements. The settings that specify the element's visibility, content and appearance are listed below. The following picture illustrates the DateNavigator control. The fast navigation panel, invoked by clicking the month or year within the calendar's header is shown at the arrow's tip.

The DateNavigator control, when dropped onto a page, should be bound to the ASPxScheduler control via its ASPxSchedulerRelatedControlBase.MasterControlID property. It is used to synchronize the time range and selected dates with the Scheduler control.

The visual appearance of the DateNavigator can be customized via the ASPxDateNavigator.Properties object. It is an instance of the DateNavigatorProperties class, derived from the CalendarProperties.

End-users can select either a particular date, or a range of dates by means of the DateNavigator control. Selecting dates using the DateNavigator control results in displaying them by the SchedulerControl, to which it is linked.

Action Effect
Click any date in the DateNavigator calendar. One day becomes selected, and the SchedulerControl displays it using the Day View. If the currently active view is of another type, it is automatically changed to Day View. The only exception is the Work Week View. In this instance, the entire work week is selected.
Click and drag across the DateNavigator calendar. The continuous range of dates is selected. The SchedulerControl adjusts the currently active view to display the selected range of dates. If the selection is smaller than a week, the view type is switched to Day View. A week-long range is displayed using the Scheduler's Full Week View. If the range is more than a week, then the Month View is used.
Hold down the CTRL key and click several dates. A set of dates is selected. The SchedulerControl displays it using the Day View, irrespective of the size of the selected range .

The table below lists the main properties which affect the appearance of the DateNavigator control:

Highlighting dates Use the DateNavigatorProperties.BoldAppointmentDates to indicate the scheduled dates with bold style.
Today button Use the DateNavigator.ShowTodayButton to display or hide the Today button. You can change its text via the CalendarProperties.TodayButtonText property.
Week numbers To display or hide week numbers use the CalendarProperties.ShowWeekNumbers property.
Highlighting weekends The rules for highlighting the weekends are specified by the CalendarProperties.HighlightWeekends property, that changes the font color to Red for holidays.
Highlight the current date Use the CalendarProperties.HighlightToday to highlight the current date.
Names of the days of the week Specify full, long or short format for the days' names via the CalendarProperties.DayNameFormat. You can also hide them via the CalendarProperties.ShowDayHeaders property.
Month and Year scroll buttons' visibility the CalendarProperties.EnableYearNavigation and CalendarProperties.EnableMonthNavigation properties define the scroll buttons visibility. The date navigation becomes restricted to dates and months displayed in the control.
Note

The CalendarProperties.MinDate and CalendarProperties.MaxDate properties are not in effect for the control.

How would you rate this topic?​​​​​​​