- 5 minutes to read
You can navigate through the SchedulerControl‘s dates, resources, and time cells. You can use commands and properties to perform these actions in code.
The topic consists of the following sections:
Navigate Through Dates
You can set the SchedulerControl.Start property to specify the date on which the scheduler initially shows its data. The Start value is used to calculate the time interval displayed in the view, however the start of the visible time interval may be different, because each view can have its display restrictions.
Use the following commands to navigate through dates:
Use the API listed below to manually navigate through different views:
|Day View, Week View, Month View||ViewBase.NavigateForward, ViewBase.NavigateBackward|
|Work Week View||WorkWeekView.NavigateForward, WorkWeekView.NavigateBackward|
|Timeline View||TimelineView.NavigateForward, TimelineView.NavigateBackward|
The SchedulerControl does not currently support IResourceNavigationService and IDateTimeNavigationService.
Users can navigate through dates within a scheduler with the Navigation ribbon group items:
Users can right-click within the main scheduler area to invoke the context menu to navigate through dates:
- Go to Today moves focus to the current day preserving the existing view mode;
- Go to Date… invokes the Go to Date dialog to select a date and view type. The date can be selected using either the calendar control or by entering a string with the placeholders. Use the Show In drop-down list to select the desired view type.
Users can navigate through dates using a DateNavigator control.
Users can click the corresponding arrows on the DateNavigator date header to navigate to the desired month and year.
Users can click the left and right scrolling buttons to navigate back and forth by one step. The Today button navigates to the current date.
Refer to the How to: Create the Scheduler with the DateNavigator for an example on how to add a DateNavigator to the scheduler.
Navigate Through Resources
Users can navigate through resources and change the number of resources each page displays using the Resource Navigator.
Users can click the buttons to move back and forth through the resources list; one by one, or straight to the last one on the list. The scheduler tracks selections and displays the corresponding resource groups. The plus and minus buttons increase or decrease the number of resources shown.
Users have two options to scroll through resources:
- Shift + Mouse Wheel (or wheel left/right tilt if the mouse support it)
The resource navigator can only be displayed when there are visible resources. Set the SchedulerViewBase.ShowResourceNavigator property to true to enable the resource navigator.
The SchedulerViewBase.ResourcesPerPage property specifies the number of resources displayed simultaneously. Both properties are individually specified for each view.
Navigate through Time Cells
The following table contains the common navigation operations available to users:
Click a cell
Moves focus to the clicked cell.
Press the UP or DOWN ARROW key
Press the LEFT or RIGHT ARROW key
Press the PAGE DOWN key
Moves the row focus one page down preserving the column focus.
Press the PAGE UP key
Moves the row focus one page up preserving the column focus.
Press the HOME key
Press the END key
Press the CTRL + HOME key
Press the CTRL + END key
Press the TAB key
Switches focus to the next time appointment within the time span shown. Pressing the key repeatedly iterates through the appointments with a definite duration, then through all-day appointments.
Press the SHIFT-TAB key
Switches focus to the previous time appointment within the time span shown. Pressing the key repeatedly iterates through the appointments with a definite duration, then through all-day appointments.
Press the ALT with UP (DOWN) ARROW keys
When appointments are grouped, only ARROW keys can move focus to another resource group.