How to configure the VisibleRange

Updated on Sep 23, 2026

The built-in RadScheduleView ViewDefinitions have specific ways to determine what the visible range will be when the CurrentDate property is set:

Type	VisibleRangeStart	VisibleDays
DayViewDefinition	CurrentDate	1
WeekViewDefinition	The first day of the week, containing CurrentDate	7
MonthViewDefinition	The first day of the first week of the month, containing CurrentDate	42
TimelineViewDefinition	CurrentDate	7

The VisibleRangeEnd is VisibleRangeStart+VisibleDays for all view definitions.

The easiest way to create a WeekViewDefinition that behaves like the DayViewDefinition is to use a DayViewDefinition and set its VisibleDays=7.

For advanced customization of the VisibleRange the ViewDefinitionBase class provides two virtual methods:

C#

protected virtual DateTime GetVisibleRangeStart(DateTime currentDate, CultureInfo culture, DayOfWeek? firstDayOfWeek) { return DateTime.Now; }

protected virtual DateTime GetVisibleRangeEnd(DateTime currentDate, CultureInfo culture, DayOfWeek? firstDayOfWeek) { return DateTime.Now; }

For example, the following class represents a MonthViewDefinition that starts from the first week of CurrentDate:

C#

public class CustomMonthViewDefinition : MonthViewDefinition
{
    protected override DateTime GetVisibleRangeStart(DateTime currentDate, CultureInfo culture, DayOfWeek? firstDayOfWeek)
    {
        return CalendarHelper.GetFirstDayOfWeek(currentDate, firstDayOfWeek.Value);
    }
}

Since VisibleDays is 42 by default, this CustomMonthViewDefinition will display 6 weeks, as the standard MonthViewDefinition does.

Here is how to use the CustomMonthViewDefinition:

XAML

<telerik:RadScheduleView>
    <telerik:RadScheduleView.ViewDefinitions>
        <local:CustomMonthViewDefinition />
    </telerik:RadScheduleView.ViewDefinitions>
</telerik:RadScheduleView>