Class
TimeBarBase

A base class for RadTimeBar and RadTimeline.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.DataVisualization.dll

Syntax:

cs-api-definition
[TelerikToolboxCategory("Data Visualization")]
public abstract class TimeBarBase : ContentControl, ISupportInitialize

Inheritance: objectTimeBarBase

Derived Classes: RadTimeBarRadTimeline

Implements: ISupportInitialize

Constructors

TimeBarBase()

Initializes a new instance of the TimeBarBase class.

Declaration

cs-api-definition
protected TimeBarBase()

Fields

ActualMinZoomRangeProperty

Identifies the ActualMinZoomRange dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ActualMinZoomRangeProperty

Field Value

DependencyProperty

ActualVisiblePeriodRangeProperty

Identifies the ActualVisiblePeriodRange dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ActualVisiblePeriodRangeProperty

Field Value

DependencyProperty

CurrentGroupIntervalProperty

Identifies the CurrentGroupInterval dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CurrentGroupIntervalProperty

Field Value

DependencyProperty

CurrentItemIntervalProperty

Identifies the CurrentItemInterval dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CurrentItemIntervalProperty

Field Value

DependencyProperty

GroupIntervalChangedEvent

Identifies the GroupIntervalChanged routed event.

Declaration

cs-api-definition
public static readonly RoutedEvent GroupIntervalChangedEvent

Field Value

RoutedEvent

GroupPeriodHeaderStyleProperty

Identifies the GroupPeriodHeaderStyle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty GroupPeriodHeaderStyleProperty

Field Value

DependencyProperty

IntervalGroupsProperty

Identifies the IntervalGroups dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IntervalGroupsProperty

Field Value

DependencyProperty

IntervalItemsProperty

Identifies the IntervalItems dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IntervalItemsProperty

Field Value

DependencyProperty

IntervalsProperty

Identifies the Intervals dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IntervalsProperty

Field Value

DependencyProperty

ItemIntervalChangedEvent

Identifies the ItemIntervalChanged routed event.

Declaration

cs-api-definition
public static readonly RoutedEvent ItemIntervalChangedEvent

Field Value

RoutedEvent

LargeChangeProperty

Identifies the LargeChange dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty LargeChangeProperty

Field Value

DependencyProperty

MaxZoomRangeProperty

Identifies the MaxZoomRange dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty MaxZoomRangeProperty

Field Value

DependencyProperty

MinZoomRangeProperty

Identifies the MinZoomRange dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty MinZoomRangeProperty

Field Value

DependencyProperty

PeriodEndProperty

Identifies the PeriodEnd dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty PeriodEndProperty

Field Value

DependencyProperty

PeriodHeaderStyleProperty

Identifies the PeriodHeaderStyle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty PeriodHeaderStyleProperty

Field Value

DependencyProperty

PeriodStartProperty

Identifies the PeriodStart dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty PeriodStartProperty

Field Value

DependencyProperty

ScrollModeProperty

Identifies the ScrollMode dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ScrollModeProperty

Field Value

DependencyProperty

SliderStyleProperty

Identifies the SliderStyle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SliderStyleProperty

Field Value

DependencyProperty

SmallChangeProperty

Identifies the SmallChange dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SmallChangeProperty

Field Value

DependencyProperty

SpecialSlotsGeneratorProperty

Identifies the SpecialSlotsGenerator dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SpecialSlotsGeneratorProperty

Field Value

DependencyProperty

SpecialSlotsProperty

Identifies the SpecialSlots dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SpecialSlotsProperty

Field Value

DependencyProperty

VisiblePeriodChangedEvent

Identifies the VisiblePeriodChanged routed event.

Declaration

cs-api-definition
public static readonly RoutedEvent VisiblePeriodChangedEvent

Field Value

RoutedEvent

VisiblePeriodEndProperty

Identifies the VisiblePeriodEnd dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty VisiblePeriodEndProperty

Field Value

DependencyProperty

VisiblePeriodProperty

Identifies the VisiblePeriod dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty VisiblePeriodProperty

Field Value

DependencyProperty

VisiblePeriodStartProperty

Identifies the VisiblePeriodStart dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty VisiblePeriodStartProperty

Field Value

DependencyProperty

Properties

ActualVisiblePeriodRange

Gets the actual visible period range.

Declaration

cs-api-definition
[Browsable(false)]
public SelectionRange<DateTime> ActualVisiblePeriodRange { get; }

Property Value

SelectionRange<DateTime>

The actual visible period range.

Remarks

When the user is dragging one of the slider thumbs, the VisiblePeriodStart and VisiblePeriodEnd properties are updated once the user releases the slider thumb. On the other hand, the ActualVisiblePeriodRange property is updated while the slider thumbs are moving.

CurrentGroupInterval

Gets the current group interval.

Declaration

cs-api-definition
public IntervalBase CurrentGroupInterval { get; }

Property Value

IntervalBase

The current group interval.

CurrentItemInterval

Gets the current item interval.

Declaration

cs-api-definition
public IntervalBase CurrentItemInterval { get; }

Property Value

IntervalBase

The current item interval.

GroupPeriodHeaderStyle

Gets or sets the HeaderStyle for every group period item.

Declaration

cs-api-definition
public Style GroupPeriodHeaderStyle { get; set; }

Property Value

Style

The HeaderStyle for every group period item.

Intervals

Gets a collection of intervals used by the control.

Declaration

cs-api-definition
public IntervalCollection Intervals { get; }

Property Value

IntervalCollection

A collection of intervals used by the control.

MaxZoomRange

Gets or sets the maximum TimeSpan that the control can zoom out to.

Declaration

cs-api-definition
public TimeSpan MaxZoomRange { get; set; }

Property Value

TimeSpan

The maximum TimeSpan that the control can zoom out to.

Remarks

The MaxZoomRange value must be greater than or equal to the value of MinZoomRange.

MinZoomRange

Gets or sets the minimum TimeSpan that the control can zoom in to.

Declaration

cs-api-definition
public TimeSpan MinZoomRange { get; set; }

Property Value

TimeSpan

The minimum TimeSpan that the control can zoom in to.

Remarks

By default, the size of the content element is restricted to 30000 pixels. This restriction is enforced by specifying a minimum zoom range using the ActualMinZoomRange property. In case MinZoomRange is specified, that is, its value is not Zero, its value is set to the ActualMinZoomRange property and the default behavior is overwritten. However, in Silverlight, due to a limitation in the framework, the 30000 pixel restriction is respected even in case a small value is specified for the MinZoomRange property.

PeriodEnd

Gets or sets the end of the period that the control visualizes. The PeriodEnd value itself is excluded from the period.

Declaration

cs-api-definition
[TypeConverter(typeof(DateTimeTypeConverter))]
public DateTime PeriodEnd { get; set; }

Property Value

DateTime

The end of the period that the control visualizes.

Remarks

The PeriodStart value must be less than or equal to the value of PeriodEnd.

PeriodHeaderStyle

Gets or sets the HeaderStyle for every period item.

Declaration

cs-api-definition
public Style PeriodHeaderStyle { get; set; }

Property Value

Style

The HeaderStyle for every period item.

PeriodStart

Gets or sets the start of the period that the control visualizes.

Declaration

cs-api-definition
[TypeConverter(typeof(DateTimeTypeConverter))]
public DateTime PeriodStart { get; set; }

Property Value

DateTime

The start of the period that the control visualizes.

Remarks

The PeriodStart value must be less than or equal to the value of PeriodEnd.

ScrollMode

Gets or sets a value that determines how manipulation input influences the horizontal scrolling and zooming behavior of the control.

Declaration

cs-api-definition
public ScrollMode ScrollMode { get; set; }

Property Value

ScrollMode

A value that determines how manipulation input influences the horizontal scrolling and zooming behavior of the control. The default is .

SliderStyle

Gets or sets the of the RadSlider.

Declaration

cs-api-definition
public Style SliderStyle { get; set; }

Property Value

Style

The of the RadSlider.

SpecialSlotsGenerator

Gets or sets an ITimeRangeGenerator instance that generates special IPeriodSpan slots for the current VisiblePeriod.

Declaration

cs-api-definition
public ITimeRangeGenerator SpecialSlotsGenerator { get; set; }

Property Value

ITimeRangeGenerator

An ITimeRangeGenerator instance that generates the special IPeriodSpan slots for the current VisiblePeriod. By default, no special slots are generated.

VisiblePeriod

Gets or sets the visible period.

Declaration

cs-api-definition
public SelectionRange<DateTime> VisiblePeriod { get; set; }

Property Value

SelectionRange<DateTime>

The visible period.

VisiblePeriodEnd

Gets or sets the end of the visible period.

Declaration

cs-api-definition
[TypeConverter(typeof(DateTimeTypeConverter))]
public DateTime VisiblePeriodEnd { get; set; }

Property Value

DateTime

The end of the visible period.

Remarks

The VisiblePeriodStart value must be less than or equal to the value of VisiblePeriodEnd. Additionally, both VisiblePeriodStart and VisiblePeriodEnd must be within the period, defined by the PeriodStart and PeriodEnd properties.

VisiblePeriodStart

Gets or sets the start of the visible period.

Declaration

cs-api-definition
[TypeConverter(typeof(DateTimeTypeConverter))]
public DateTime VisiblePeriodStart { get; set; }

Property Value

DateTime

The start of the visible period.

Remarks

The VisiblePeriodStart value must be less than or equal to the value of VisiblePeriodEnd. Additionally, both VisiblePeriodStart and VisiblePeriodEnd must be within the period, defined by the PeriodStart and PeriodEnd properties.

Methods

ConvertPointToDateTime(Point)

Converts a point inside the control to a DateTime value relative to the timeline.

Declaration

cs-api-definition
public DateTime ConvertPointToDateTime(Point coordinates)

Parameters

coordinates

Point

Position inside the control.

Returns

DateTime

The DateTime value relative to the timeline.

EndInit()

Indicates that the initialization process for the element is complete.

Declaration

cs-api-definition
public override void EndInit()

Exceptions

InvalidOperationException

was called without having previously been called on the element.

Implements ISupportInitialize.EndInit()

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes call .

Declaration

cs-api-definition
public override void OnApplyTemplate()

OnGroupIntervalChanged(IntervalBase, IntervalBase)

Called when the CurrentGroupInterval changes.

Declaration

cs-api-definition
protected virtual void OnGroupIntervalChanged(IntervalBase oldInterval, IntervalBase newInterval)

Parameters

oldInterval

IntervalBase

The old interval.

newInterval

IntervalBase

The new interval.

OnInitialized(EventArgs)

Raises the event. This method is invoked whenever is set to true internally.

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

The RoutedEventArgs that contains the event data.

OnItemIntervalChanged(IntervalBase, IntervalBase)

Called when the CurrentItemInterval changes.

Declaration

cs-api-definition
protected virtual void OnItemIntervalChanged(IntervalBase oldInterval, IntervalBase newInterval)

Parameters

oldInterval

IntervalBase

The old interval.

newInterval

IntervalBase

The new interval.

OnMouseWheel(MouseWheelEventArgs)

Raises the event.

Declaration

cs-api-definition
protected override void OnMouseWheel(MouseWheelEventArgs e)

Parameters

e

MouseWheelEventArgs

The MouseWheelEventArgs instance containing the event data.

OnSliderSelectionChanged(object, RadRoutedEventArgs)

Called when the Selection of the RadSlider changes.

Declaration

cs-api-definition
protected virtual void OnSliderSelectionChanged(object sender, RadRoutedEventArgs e)

Parameters

sender

object

The RadSlider instance.

e

RadRoutedEventArgs

The RadRoutedEventArgs instance containing the event data.

OnVisiblePeriodChanged()

Called when the VisiblePeriodStart or the VisiblePeriodEnd change.

Declaration

cs-api-definition
protected virtual void OnVisiblePeriodChanged()

RegisterCommand(ICommand, ExecutedRoutedEventHandler, CanExecuteRoutedEventHandler)

Registers an ICommand with the TimeBarBase type.

Declaration

cs-api-definition
protected static void RegisterCommand(ICommand command, ExecutedRoutedEventHandler executed, CanExecuteRoutedEventHandler canExecute)

Parameters

command

ICommand

The ICommand to register.

executed

ExecutedRoutedEventHandler

The handler for the event on the new RoutedCommand.

canExecute

CanExecuteRoutedEventHandler

The handler for the event on the new RoutedCommand.

Events

ActualVisiblePeriodRangeChanged

Occurs when the actual visible period range changes.

Declaration

cs-api-definition
public event EventHandler ActualVisiblePeriodRangeChanged

Event Value

EventHandler

GroupIntervalChanged

Occurs when the CurrentGroupInterval changes.

Declaration

cs-api-definition
public event EventHandler<DrillEventArgs> GroupIntervalChanged

Event Value

EventHandler<DrillEventArgs>

ItemIntervalChanged

Occurs when the CurrentItemInterval changes.

Declaration

cs-api-definition
public event EventHandler<DrillEventArgs> ItemIntervalChanged

Event Value

EventHandler<DrillEventArgs>

VisiblePeriodChanged

Occurs when the VisiblePeriodStart or the VisiblePeriodEnd change.

Declaration

cs-api-definition
public event RadRoutedEventHandler VisiblePeriodChanged

Event Value

RadRoutedEventHandler