Date Navigator
- 2 minutes to read
This topic describes the Date Navigator pane, which provides a quick and easy way to change the dates shown in the scheduling area.
The Date Navigator pane can be used to change time Views between Day, Week, and Weeks. The Date Navigator is represented by a TcxSchedulerDateNavigator object.
Along with the Control Box pane, the Date Navigator pane can occupy the right, left, top, or bottom side of the scheduler control (dependent upon the scheduler’s OptionsView.ViewPosition property value).
Clicking on the Date Navigator‘s header displays a month context menu. The single-arrow buttons change the dates displayed in it, by incrementing or decrementing the time range displayed by a month at a time.
The Date Navigator‘s calendar shows the current month along with a few days from the previous and next months (if the scheduler’s DateNavigator.ColCount and DateNavigator.RowCount properties are both set to 1).
Today’s date (provided by the host environment) is outlined with a border around it – the current date indicator. This makes it quick and easy to identify the current day.
Dates which have user events scheduled on them are shown in bold in the Date Navigator (if the scheduler’s DateNavigator.ShowDatesContainingEventsInBold property is set to True).
The selected date(s) is highlighted. To select multiple nonadjacent dates simultaneously the Control key is used along with the mouse. Adjacent dates can be selected by dragging the mouse pointer over the desired days while the left mouse button is pressed or by using the Shift key along with the mouse. The selected dates are then displayed in the scheduling area. Note: multiple selection is available only if the scheduler’s DateNavigator.SelectPeriod property is set to True.
Weeks of the year are assigned a number from 1 to 52/53/54, called week numbers. Week numbers are displayed on the left side of the Date Navigator. They can be used to select any entire week.
For details on how to custom paint the Date Navigator‘s elements or apply styles to the Date Navigator please refer to the Custom Drawing or Styles topics.