New to Telerik UI for WinForms? Download free 30-day trial

Scheduler Element Provider

The SchedulerElementProvider class provides means for changing the default RadScheduler elements.

Figure 1: Custom Appointments

WinForms RadScheduler Custom Appointments

If you need to customize any of the RadSheduler elements you can use the SchedulerElementProvider class. It allows you to replace the default elements with custom ones. This can be achieved by creating SchedulerElementProvider descendant class and overriding the corresponding methods.

Custom Element Provider

public class MyElementProvider : SchedulerElementProvider
{
    public MyElementProvider(RadScheduler scheduler)
        : base(scheduler)
    {
    }
    protected override T CreateElement<T>(SchedulerView view, object context)
    {
        if (typeof(T) == typeof(AppointmentElement))
        {
            return new MyAppointmentElement(this.Scheduler, view, (IEvent)context) as T;
        }
        if (typeof(T) == typeof(SchedulerCellElement))
        {
            return new MySchedulerCellElement(this.Scheduler, view) as T;
        }
        return base.CreateElement<T>(view, context);
    }
    public override RulerPrimitive CreateRulerPrimitive(DayViewAppointmentsArea area, SchedulerTimeZone timeZone)
    {
        return new MyRulerPrimitive(this.Scheduler, area);
    }
}

Public Class MyElementProvider
    Inherits SchedulerElementProvider
    Public Sub New(scheduler As RadScheduler)
        MyBase.New(scheduler)
    End Sub
    Protected Overrides Function CreateElement(Of T As SchedulerVisualElement)(view As SchedulerView, context As Object) As T
        If GetType(T) = GetType(AppointmentElement) Then
            Return TryCast(New MyAppointmentElement(Me.Scheduler, view, DirectCast(context, IEvent)), T)
        End If
        If GetType(T) = GetType(SchedulerCellElement) Then
            Return TryCast(New MySchedulerCellElement(Me.Scheduler, view), T)
        End If
        Return MyBase.CreateElement(Of T)(view, context)
    End Function
    Public Overrides Function CreateRulerPrimitive(area As DayViewAppointmentsArea, timeZone As SchedulerTimeZone) As RulerPrimitive
        Return New MyRulerPrimitive(Me.Scheduler, area)
    End Function
End Class

Your custom elements should be inherit of the default ones. For example, you can create custom elements and override some of their default properties.

Custom Cells

public class MySchedulerCellElement : SchedulerCellElement
{
    public MySchedulerCellElement(RadScheduler scheduler, SchedulerView view)
        : base(scheduler, view)
    {
    }
    protected override void InitializeFields()
    {
        base.InitializeFields();
        this.BorderWidth = 2;
        this.BackColor = ColorTranslator.FromHtml("#f5e020");
        this.Text = "Text";
    }
}
public class MyAppointmentElement : AppointmentElement
{
    public MyAppointmentElement(RadScheduler scheduler, SchedulerView view, IEvent appointment)
        : base(scheduler, view, appointment)
    {
    }
    protected override void InitializeAppointment()
    {
        base.InitializeAppointment();
        this.BackColor = ColorTranslator.FromHtml("#91c930");
        this.BackColor2 = ColorTranslator.FromHtml("#51ab2e");
        this.SelectedBorderColor = ColorTranslator.FromHtml("#005Bbc");
    }
}
public class MyRulerPrimitive : RulerPrimitive
{
    public MyRulerPrimitive(RadScheduler scheduler, DayViewAppointmentsArea area)
        : base(scheduler, area)
    {
        this.BackColor = ColorTranslator.FromHtml("#91c930");
        this.Font = new Font("Segoe Script", 12, FontStyle.Underline);
        this.ForeColor = ColorTranslator.FromHtml("#bb2525");
    }
}

Public Class MySchedulerCellElement
    Inherits SchedulerCellElement
    Public Sub New(scheduler As RadScheduler, view As SchedulerView)
        MyBase.New(scheduler, view)
    End Sub
    Protected Overrides Sub InitializeFields()
        MyBase.InitializeFields()
        Me.BorderWidth = 2
        Me.BackColor = ColorTranslator.FromHtml("#f5e020")
        Me.Text = "Text"
    End Sub
End Class
Public Class MyAppointmentElement
    Inherits AppointmentElement
    Public Sub New(scheduler As RadScheduler, view As SchedulerView, appointment As IEvent)
        MyBase.New(scheduler, view, appointment)
    End Sub
    Protected Overrides Sub InitializeAppointment()
        MyBase.InitializeAppointment()
        Me.BackColor = ColorTranslator.FromHtml("#91c930")
        Me.BackColor2 = ColorTranslator.FromHtml("#51ab2e")
        Me.SelectedBorderColor = ColorTranslator.FromHtml("#005Bbc")
    End Sub
End Class
Public Class MyRulerPrimitive
    Inherits RulerPrimitive
    Public Sub New(scheduler As RadScheduler, area As DayViewAppointmentsArea)
        MyBase.New(scheduler, area)
        Me.BackColor = ColorTranslator.FromHtml("#91c930")
        Me.Font = New Font("Segoe Script", 12, FontStyle.Underline)
        Me.ForeColor = ColorTranslator.FromHtml("#bb2525")
    End Sub
End Class

The following RadSheduler elements can be substituted in the CreateElement method.

Scheduler Element
AppointmentElement
DayViewAllDayHeader
DayViewAppointmentsArea
DayViewAppointmentsTable
DayViewHeader
DragFeedbackElement
MonthCellElement
MonthViewAreaElement
MonthViewHeader
MonthViewVerticalHeader
SchedulerCellElement
SchedulerDayViewElement
SchedulerDayViewGroupedByResourceElement
SchedulerHeaderCellElement
SchedulerMonthViewElement
SchedulerMonthViewGroupedByResourceElement
SchedulerMultiDayViewElement
SchedulerResourceHeaderCellElement
SchedulerTimelineViewElement
TimelineAppointmentsPresenter
TimelineGroupingByResourcesElement
TimelineHeader
ViewNavigationElement

See Also

In this article