Edit this page

Customizing Zoom Navigation

This article will guide you through the process of creating a month-year picker. For this purpose, it is necessary to set the HeaderNavigationMode property to HeaderNavigationMode.Zoom and set the ZoomLevel property to ZoomLevel.Months. This will allow the user to select a specific CalendarCellElement and navigate upwards/downwards in the RadCalendar similar to Windows calendar.

this.radCalendar1.HeaderNavigationMode = HeaderNavigationMode.Zoom;
this.radCalendar1.ZoomLevel = ZoomLevel.Months;
this.radCalendar1.ZoomChanging += new CalendarZoomChangingEventHandler(radCalendar1_ZoomChanging);

Me.RadCalendar1.HeaderNavigationMode = HeaderNavigationMode.Zoom
Me.RadCalendar1.ZoomLevel = ZoomLevel.Months
AddHandler Me.RadCalendar1.ZoomChanging, AddressOf radCalendar1_ZoomChanging

In addition, you should subscribe to the ZoomChanging event and stop navigation from the currently selected month to its days representation and from a year to a range of years.

void radCalendar1_ZoomChanging(object sender, CalendarZoomChangingEventArgs e)
{
    if (this.radCalendar1.ZoomLevel == ZoomLevel.Years && e.Direction == DrillDirection.Up)
    {
        e.Cancel = true;
    }
    if (this.radCalendar1.ZoomLevel == ZoomLevel.Months && e.Direction == DrillDirection.Down)
    {
        e.Cancel = true;
    }
}

Private Sub radCalendar1_ZoomChanging(sender As Object, e As CalendarZoomChangingEventArgs)
    If Me.RadCalendar1.ZoomLevel = ZoomLevel.Years AndAlso e.Direction = DrillDirection.Up Then
        e.Cancel = True
    End If
    If Me.RadCalendar1.ZoomLevel = ZoomLevel.Months AndAlso e.Direction = DrillDirection.Down Then
        e.Cancel = True
    End If
End Sub

Figure 1: The zoom level is limited to months.

calendar-customizing-behavior-customizing-zoom-navigation 001

See Also