Properties

There is a required precedence of the TimeBar's properties. This means that the Start Time should always be set before the End Time. A required precedence of Properties is given in the code snippet below.

<telerik:RadTimeBar x:Name="timeBar" Width="950" Height="250"       
                    PeriodStart="01-01-2011" 
                    PeriodEnd="01/01/2012" 
                    VisiblePeriodStart="01/01/2011" 
                    VisiblePeriodEnd="06/01/2011" 
                    SelectionStart="02/01/2011" 
                    SelectionEnd="03/01/2011" 
                    MinSelectionRange="28.00:00:00"                             
                    MaxSelectionRange="31.00:00:00"                             
                    IsSnapToIntervalEnabled="True" > 
    <telerik:RadTimeBar.Intervals> 
        <telerik:MonthInterval /> 
    </telerik:RadTimeBar.Intervals> 
</telerik:RadTimeBar> 

PeriodStart: Gets or sets the timeline's start date PeriodEnd: Gets or sets the timeline's end data VisiblePeriodStart: Gets or sets the currently visible start date VisiblePeriodEnd: Gets or sets the the currently visible end date Intervals: Determines the displayed time intervals

Currently the supported intervals are:

• Century
• Decade
• Year
• Quarter
• Month
• Week
• Day
• Hour
• Minute
• Second
• Millisecond

A sample Intervals section may look like this:

<telerik:RadTimeBar.Intervals> 
     <telerik:YearInterval /> 
     <telerik:MonthInterval/> 
     <telerik:WeekInterval/> 
     <telerik:DayInterval/> 
 </telerik:RadTimeBar.Intervals> 

Every interval has a preset collection of formatting strings that creates the string representation of a given date to match the interval. RadTimeBar automatically choses the appropriate string formatter according to the control size and visible range. For example year interval uses the following set of formatting strings:

“yyyy”

“yy”

SelectionStart and SelectionEnd: These properties determine the beginning of the selected range in the TimeBar control.

ActualSelectionStart and ActualSelectionEnd: When the user is dragging one of the selection thumbs, the SelectionStart and SelectionEnd properties are updated once the user releases the selection thumb. On the other hand, the ActualSelectionStart and ActualSelectionEnd properties are updated while the selection thumbs are moving.

IsSnapToIntervalEnabled: This turns on the snapping functionality, which will restrict the moving of the selection thumb, so that it will snap to the items' lines.

MinSelectionRange and MaxSelectionRange: These properties define the Selection Range interval thus you won't be able to select interval lower than the MinSelectionRange and higher than MaxSelectionRange.

IntervalSpans: This property can be set from each Interval except Decade and Quarter. It is used to group the given Interval Items Together. For example setting:

<telerik:RadTimeBar.Intervals> 
   <telerik:SecondInterval IntervalSpans="10"/> 
</telerik:RadTimeBar.Intervals> 

will make the seconds in groups with 10 each. You can also set more than one IntervalSpan simultaneously by separating them with comma:

<telerik:RadTimeBar.Intervals> 
   <telerik:SecondInterval IntervalSpans="10,15,30" /> 
   <telerik:MinuteInterval IntervalSpans="1,10,15,30" /> 
</telerik:RadTimeBar.Intervals> 

CurrentItemInterval and CurrentGroupInterval: These properties can be used in code-behind to take the current item respectively group interval span set.

MinZoomRange and MaxZoomRange: These properties set the minimal and maximum range of the TimeBar that can be zoomed.