[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Collapse]Scheduler
   [Expand]Getting Started
   [Expand]Appointments
    Resources
    Reminders
   [Expand]Views
   [Expand]Visual Elements
   [Expand]Styles and Templates
   [Expand]Design-Time Features
    Time Zones
   [Expand]Data Binding
    Grouping
    Selecting
    Navigating
    Printing
    End-User Restrictions
   [Expand]Examples
    Migration Guidelines
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Navigating

The SchedulerControl enables you to navigate through dates, resources and time cells at runtime and provides necessary commands and properties to perform these actions manually.

The topic consists of the following sections:

Expanded 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.

The SchedulerControl provides the following commands to navigate through dates:

Use the API listed below to manually navigate through different Views:

View Methods
Day View, Week View, Month View ViewBase.NavigateForward, ViewBase.NavigateBackward
Work Week View WorkWeekView.NavigateForward, WorkWeekView.NavigateBackward
Timeline View TimelineView.NavigateForward, TimelineView.NavigateBackward
Note

The SchedulerControl does not currently support IResourceNavigationService and IDateTimeNavigationService.

End-users can navigate through dates within a scheduler using the Navigation ribbon group items:

Right-clicking within the main scheduler area invokes the context menu which contains items for navigation 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 for selecting 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.

Expanded Date Navigator

End-users can navigate through dates using a DateNavigator control. You can navigate to the desired month and year by clicking the corresponding arrows on the DateNavigator date header. Clicking the left and right scrolling buttons navigates back and forth by one step. Clicking the Today button navigates to the current date. The animation below shows the DateNavigator control capabilities:

Expanded Show Animation

Refer to the How to: Create the Scheduler with the DateNavigator for an example on how to provide the SchedulerControl with a DateNavigator.

Expanded Navigate Through Resources

End-users can navigate through resources and change the number of resources each page displays using the Resource Navigator. The user 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 scrollbar scrolls through resources. The scheduler tracks selections and displays the corresponding resource groups. The plus and minus buttons increase or decrease the number of resources shown.

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.

Expanded Navigate through Time Cells

The following table contains the common navigation operations available to end-users:

Action

Effect

Clicking a cell

Moves focus to the clicked cell.

Pressing the UP or DOWN ARROW key

  • Day View, Work Week View - Moves focus to the previous or next time cell within the current day;
  • Week View - Moves focus to the previous or next day;
  • Month View - Moves focus to the same day of the week for the previous or next week.

Pressing the LEFT or RIGHT ARROW key

  • Day View, Work Week View - Moves focus to the corresponding time cell of the previous or next day;
  • Week View - Moves focus to the left or right of the corresponding column cell. The view is scrolled to the previous or next week if necessary;Month View - Moves focus to the previous or next day.

Pressing the PAGE DOWN key

Moves the row focus one page down preserving the column focus.

Pressing the PAGE UP key

Moves the row focus one page up preserving the column focus.

Pressing the HOME key

Pressing the END key

  • Day View, Work Week View - Moves focus to the SchedulerControl.WorkTime's last cell within the current day;
  • Week View, Month View - Moves focus to the last day shown in the current week.

Pressing the CTRL + HOME key

  • Day View, Work Week View - Moves focus to the first cell of the day's visible time span;
  • Week View, Month View - Moves focus to the first day shown in the current week.

Pressing the CTRL + END key

  • Day View, Work Week View - Moves focus to the last cell of the day's visible time span;
  • Week View, Month View - Moves focus to the last day shown in the current week.

Pressing 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.

Pressing 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.

Pressing the ALT with UP (DOWN) ARROW keys

  • Day View, Work Week View, Month View - Moves focus one week before or after;
  • Week View - acts as LEFT(RIGHT) ARROW keys.
Note

When appointments are grouped, only ARROW keys can move focus to another resource group.

Is this topic helpful?​​​​​​​