NavigationCommand
The NavigationCommand occurs when the user clicks on a control that changes the selected day, view, or mode of the scheduler.
NavigationCommand has two parameters:
sender is the scheduler control.
e is an object of type SchedulerNavigationCommandEventArgs. It has three properties:
Command indicates what control the user clicked. Possible values are listed in the table below.
SelectedDay is a DateTime specifying the target date when Command is SchedulerNavigationCommand.SwitchToSelectedDay.
Cancel is a boolean value that lets you prevent the scheduler from responding to the navigation command.
The Command property is of type SchedulerNavigationCommand. This type has the following possible values:
| Name | Description |
|---|---|
| DisplayNextAppointmentSegment | The user clicked the right-pointing arrow in an appointment to move to the next day. |
| DisplayPreviousAppointmentSegment | The user clicked the left-pointing arrow in an appointment to move to the previous day. |
| NavigateToNextPeriod | The user clicked the right-pointing arrow in the navigation pane. |
| NavigateToPreviousPeriod | The user clicked the left-pointing arrow in the navigation pane. |
| SwitchFullTime | The user clicked the link button in the footer to switch from full-day mode to business hours (or vice versa). |
| SwitchToDayView | The user clicked the Day button of the view tabs when the scheduler was not already in Day view. |
| SwitchToWeekView | The user clicked the Week button of the view tabs when the scheduler was not already in Week view. |
| SwitchToMonthView | The user clicked the Month button of the view tabs when the scheduler was not already in Month view. |
| SwitchToSelectedDay | The user clicked the today button in the navigation pane or the "show more" link in a cell in Month view. The SelectedDay parameter is the day to which the scheduler will be switched. |
| SwitchToMultiDayView | The user clicked the Multi-Day button of the view tabs when the scheduler was not already in Multi-day view. |
| NavigateToSelectedDate | Used when the integrated date picker is the source of the NavigationCommand event. |
Example
This example disables the "today" button, while still allowing a switch to Day view from a cell in Month view.
protected void RadScheduler1_NavigationCommand(object sender, SchedulerNavigationCommandEventArgs e)
{
if (e.Command == SchedulerNavigationCommand.SwitchToSelectedDay && RadScheduler1.SelectedView == SchedulerViewType.DayView)
e.Cancel = true;
}
Protected Sub RadScheduler1_NavigationCommand(ByVal sender As Object, _
ByVal e As SchedulerNavigationCommandEventArgs) _
Handles RadScheduler1.NavigationCommand
If e.Command = SchedulerNavigationCommand.SwitchToSelectedDay AndAlso _
RadScheduler1.SelectedView = SchedulerViewType.DayView Then
e.Cancel = True
End If
End Sub