Define a Custom ViewDefinition
This topic will demonstrate the customization capabilities provided by RadScheduleView for defining a custom ViewDefinition. Determining which ViewDefinition to inherit, so that the needed customizations are based on it, depends on the particular needs. More information on the built-in ViewDefinitions can be found in the Overview topic.
As modifying the appearance of different elements of the control is discussed in this article, it is recommended to review the Visual Structure topic first.
Custom DateGroupDescription
When a custom ViewDefinition based on WeekViewDefinition or MonthViewDefinition is defined, you could customize the grouping of the used DateGroupDescription. In this case the DateGroupDescription property of the ViewDefinition needs to be overriden by returning a custom object inheriting from DateGroupDescription. The custom DateGroupDescription object needs to override the GroupLength property.
Example 1: Defining the custom DateGroupDescription
class MyGroupDescription : DateGroupDescription
{
public override TimeSpan GroupLength
{
get
{
return TimeSpan.FromDays(2);
}
}
}
Class MyGroupDescription
Inherits DateGroupDescription
Public Overrides ReadOnly Property GroupLength() As TimeSpan
Get
Return TimeSpan.FromDays(2)
End Get
End Property
End Class
After the needed DateGroupDescription is defined, it needs to be returned by the DateGroupDescription property of the custom ViewDefinition.
Example 2: Return the custom DateGroupDescription
protected override DateGroupDescription DateGroupDescription
{
get
{
return new MyGroupDescription();
}
}
Protected Overrides ReadOnly Property DateGroupDescription() As DateGroupDescription
Get
Return New MyGroupDescription()
End Get
End Property
Figure 1: Custom DateGroupDescription
Set the Format of the Group Header
The format of the Group Header can be altered by overriding the FormatGroupHeaderName method.
Example 3: Set the format of the Group Header
protected override string FormatGroupHeaderName(IFormatProvider formatInfo, object groupName)
{
var date = (DateTime)groupName;
return String.Format("{0} {1}", date.DayOfWeek, date.Day);
}
Protected Overrides Function FormatGroupHeaderName(formatInfo As IFormatProvider, groupName As Object) As String
Dim [date] = DirectCast(groupName, DateTime)
Return [String].Format("{0} {1}", [date].DayOfWeek, [date].Day)
End Function
Figure 2: Formatted GroupHeader name
Format the Text of the Visible Range
The format of the string that represents the currently visible range can be modified by overriding the FormatVisibleRangeText method.
Example 4: Set the format of the currently visible range text
protected override string FormatVisibleRangeText(IFormatProvider formatInfo,
DateTime rangeStart, DateTime rangeEnd, DateTime currentDate)
{
return String.Format("Start: {0}.{1}, End: {2}.{3}",
rangeStart.Day, rangeStart.Month, rangeEnd.Day, rangeEnd.Month);
}
Protected Overrides Function FormatVisibleRangeText(formatInfo As IFormatProvider,
rangeStart As DateTime, rangeEnd As DateTime, currentDate As DateTime) As String
Return [String].Format("Start: {0}.{1}, End: {2}.{3}", rangeStart.Day, rangeStart.Month, rangeEnd.Day, rangeEnd.Month)
End Function
Figure 3: Modified format of the visible range text
Show the Week Group Headers
By default, the week group headers are hidden. They can be shown by overriding the GetShowWeekGroupHeaders method
Example 5: Show the week group headers
protected override bool GetShowWeekGroupHeaders()
{
return true;
}
Protected Overrides Function GetShowWeekGroupHeaders() As Boolean
Return True
End Function
Figure 4: Showing the week group headers
Set the Beginning and the End of the Visible Range
The DateTime values for the start and end of the visible range, can be set through the GetVisibleRangeStart and GetVisibleRangeEnd methods.
Example 6: Setting visible range
protected override DateTime GetVisibleRangeStart(DateTime dateTime,
System.Globalization.CultureInfo culture, DayOfWeek? firstDayOfWeek)
{
return dateTime;
}
protected override DateTime GetVisibleRangeEnd(DateTime dateTime,
System.Globalization.CultureInfo culture, DayOfWeek? firstDayOfWeek)
{
return dateTime.AddDays(5);
}