Provides the Cartesian-series overview and pan/zoom synchronization used when a RadChartView is associated with a RadRangeSelector.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.ChartView.dll
Syntax:
public class RangeSelectorViewElement : RadChartElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider, IRangeSelectorElement
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementRadChartElementRangeSelectorViewElement...
Implements:
Inherited Members
Constructors
Creates an overview from the associated chart and connects it to that chart's resize, pan, and zoom notifications.
public RangeSelectorViewElement(RadChartElement mainChartElement)
The chart element whose Cartesian series and view state are represented by the overview.
Properties
Gets the cached size of the associated chart's Cartesian plot area used during range synchronization.
public SizeF AreaSize { get; }
Gets the chart element whose series and view state are represented by this overview.
public RadChartElement AssociatedViewElement { get; }
Gets the pan/zoom controller used to synchronize the associated chart.
public ChartPanZoomController AssociatedViewElementZoomControler { get; }
Gets or sets the end of the visible interval in the associated chart, as a percentage of its full range.
public float AssociatedViewEnd { get; set; }
Implements:
Gets or sets the start of the visible interval in the associated chart, as a percentage of its full range.
public float AssociatedViewStart { get; set; }
Implements:
Gets the mutable list of scale containers displayed at the bottom-right side of the range selector.
public List<RangeSelectorScaleContainerElement> BottomRightScales { get; }
Gets or sets whether pan and zoom changes in the associated chart update the range selector's selected interval. Disabling this one-way synchronization does not prevent range-selector interaction from updating the chart.
public bool EnablePanAndZoomSynchronization { get; set; }
Gets or sets the minimum selected interval, expressed as a percentage of the full view range. The default is 3; values are not validated by the setter.
public float MinSelectionLenght { get; set; }
Gets or sets the end of the selected interval in the overview, as a percentage of its full range.
public float RangeSelectorViewEnd { get; set; }
Implements:
Gets or sets the start of the selected interval in the overview, as a percentage of its full range.
public float RangeSelectorViewStart { get; set; }
Implements:
Gets or sets the end of the visible zoom window in the overview, as a percentage of its full range.
public float RangeSelectorViewZoomEnd { get; set; }
Implements:
Gets or sets the start of the visible zoom window in the overview, as a percentage of its full range.
public float RangeSelectorViewZoomStart { get; set; }
Implements:
Gets or sets which side of the range selector receives the generated scales. Changing the value rebuilds the scale lists from the overview's axes.
public ViewPosition ScalesPosition { get; set; }
Gets the type used to obtain the chart element's theme settings.
protected override Type ThemeEffectiveType { get; }
Overrides:
Gets the mutable list of scale containers displayed at the top-left side of the range selector.
public List<RangeSelectorScaleContainerElement> TopLeftScales { get; }
Methods
Reuses the associated chart's lasso-zoom controller when present; otherwise creates a pan/zoom controller for the chart.
Detaches the event handlers registered on the associated chart before releasing managed resources.
protected override void DisposeManagedResources()
Overrides:
Gets the same mutable scale list exposed by BottomRightScales.
public List<RangeSelectorScaleContainerElement> GetBottomRightScales()
List<RangeSelectorScaleContainerElement>
The scale containers positioned at the bottom-right side.
Implements:
Gets the same mutable scale list exposed by TopLeftScales.
public List<RangeSelectorScaleContainerElement> GetTopLeftScales()
List<RangeSelectorScaleContainerElement>
The scale containers positioned at the top-left side.
Implements:
Rebuilds the overview series and axis scales for the associated chart. The width and height arguments are currently ignored.
Raises the LabelInitializing event before adding a scale label to the overview.
public virtual void OnLabelInitializing(LabelInitializingEventArgs e)
The label element and cancellation state.
Raises the RefreshNeeded event after the associated view changes the range that should be shown by the selector.
protected virtual void OnRefreshNeeded(EventArgs e)
Event data for the refresh notification.
Raises the SeriesInitialized event after adding a copied series to the overview.
public virtual void OnSeriesInitialized(SeriesInitializedEventArgs e)
The generated overview series.
Raises the SeriesInitializing event before creating a copied overview series.
public virtual void OnSeriesInitializing(SeriesInitializingEventArgs e)
The source series, requested copy type, and cancellation state.
Applies the selected percentage interval to the associated chart's horizontal zoom and pan. The interval is clamped to a zoom factor between 1 and 100; the operation is skipped when its endpoints are equal or the plot width is zero.
public void UpdateAssociatedView()
Implements:
Rebuilds the overview by copying associated Cartesian series that are not canceled by SeriesInitializing. Copies include data points and applicable axis and appearance settings.
public virtual void UpdateRangeChartView()
The associated chart contains a series that is not a CartesianSeries.
Currently performs no operation; it is retained as the overview-refresh hook required by IRangeSelectorElement.
public void UpdateRangeSelectorView()
Implements:
Recreates the scale containers from the overview's first Cartesian axes, then hides the overview's axes.
public void UpdateScales()
Events
Occurs when labels in scale element are initializing. This event firing only for the labels that are displaying in RadRangeSelector.
public event LabelInitializingEventHandler LabelInitializing
Occurs when [refresh needed].
public event EventHandler RefreshNeeded
Implements:
Occurs when series is Initialized.
public event SeriesInitializedEventHandler SeriesInitialized
Occurs when series is Initializing.
public event SeriesInitializingEventHandler SeriesInitializing