ChartSeries
Base class for chart data series. It owns the data-point collection and shared data binding, style, and palette behavior; derived classes provide the series model and point visuals.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.ChartView.dll
Syntax:
public abstract class ChartSeries : UIChartElement, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, IStylableElement, IStylableNode, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IShapedElement, IChartSeries, IChartElementPresenter, IAxisProvider
Inheritance: objectDisposableObjectRadObjectUIChartElementChartSeries
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes a new instance of the ChartSeries class.
public ChartSeries()
Fields
Identifies whether connector lines are drawn between data points and their labels.
public static RadProperty DrawLinesToLabelsProperty
Identifies the format applied to each data point's Label using the series' LabelFormatProvider.
public static RadProperty LabelFormatProperty
Identifies the rotation angle applied to the data labels of this series.
public static RadProperty LabelRotationAngleProperty
Identifies the color used for label connector lines when SyncLinesToLabelsColor is false.
public static RadProperty LinesToLabelsColorProperty
Identifies the property that supplies the default marker size for data points in this series.
public static RadProperty PointSizeProperty
Identifies whether label connector lines use the point's color instead of LinesToLabelsColor.
public static RadProperty SyncLinesToLabelsColorProperty
Properties
Gets the axes.
[Browsable(false)]
public virtual Axis[] Axes { get; }
The axes.
Implements:
Gets the bounds of the series
[Browsable(false)]
public RectangleF Bounds { get; }
Gets or sets the name of the list or table in the data source for which the ChartSeries is bound.
[Browsable(true)]
public string DataMember { get; set; }
Gets the data points.
[Browsable(true)]
public ChartDataPointCollection DataPoints { get; }
The data points.
Gets or sets the data source of the ChartSeries.
public object DataSource { get; set; }
Gets or sets the display member.
[Browsable(true)]
public string DisplayMember { get; set; }
The display member.
Gets or sets a value indicating whether to draw lines between data points and labels.
public bool DrawLinesToLabels { get; set; }
Gets or sets a value indicating whether this instance is visible.
public override bool IsVisible { get; set; }
Overrides:
Implements:
Gets or sets the format used to format all the labels present on the axis.
public string LabelFormat { get; set; }
Gets or sets the format provider to be used for the labels of the axis.
[Browsable(false)]
public IFormatProvider LabelFormatProvider { get; set; }
Gets or sets the label rotation angle.
public double LabelRotationAngle { get; set; }
The label rotation angle.
Gets or sets the color of the lines connecting data points to their labels.
public Color LinesToLabelsColor { get; set; }
The color of the lines.
Gets the model.
[Browsable(false)]
public abstract ChartSeriesModel Model { get; }
The model.
Gets or sets the name.
[Browsable(true)]
public string Name { get; set; }
The name.
Gets or sets the palette.
[Browsable(false)]
public PaletteEntry Palette { get; set; }
The palette.
Gets or sets the size of the points of the series
public SizeF PointSize { get; set; }
Gets the selected style.
[Browsable(false)]
public virtual ChartStyle SelectedStyle { get; }
The selected style.
Gets or sets a value indicating whether the series will display a label associated with each data point.
public bool ShowLabels { get; set; }
Gets or sets a value indicating whether to sync the color of the line connecting a data point and its label.
public bool SyncLinesToLabelsColor { get; set; }
true if color is synced; otherwise, false.
Gets the trackball format string.
protected virtual string TrackballFormatString { get; }
The trackball format string.
Methods
Applies the style settings.
protected override void ApplyStyleSettingsCore(PropertySettingGroup group)
The group.
Overrides:
Binds the members.
protected virtual void BindMembers()
Creates the data point.
Creates the data point element.
protected DataPointElement CreateDataPointElement(DataPoint point)
The point.
Returns:Creates the data point element collection.
protected virtual ChartElementCollection CreateDataPointElementCollection()
Creates the series-specific fallback point when point-creation handlers do not supply one.
protected abstract DataPoint CreateDefaultDataPoint()
A new data point appropriate for this series.
Creates the data-point collection and initializes the model specific to this series.
protected abstract ChartDataPointCollection CreateModel()
The collection assigned to DataPoints.
Creates the visual element used to render a data point when chart-level point-element creation does not supply a replacement.
protected abstract DataPointElement CreatePointElement(DataPoint point)
The data point represented by the element.
Returns:The visual element for point.
Disposes managed resources.
protected override void DisposeManagedResources()
Overrides:
Ensures the visual state.
Gets the element.
Gets the index of the style.
Called when the palette is applied.
protected virtual void OnApplyPalette()
Called when [attached].
protected override void OnAttached(UIChartElement parent)
The parent.
Overrides:
Raises the event.
protected virtual void OnCreatePoint(ChartViewCreatePointEventArgs e)
The ChartViewCreatePointEventArgs instance containing the event data.
Called when [dettached].
protected override void OnDettached()
Overrides:
Invalidates the owning chart when a property affecting point size, label formatting, label rotation, or label connectors changes.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Details of the changed property.
Overrides:
Raises TrackballPointTextNeeded so handlers can replace the displayed text for a point.
protected virtual void OnTrackballPointTextNeeded(TrackballPointTextNeededEventArgs e)
The point and its initial trackball text.
Refreshes the UIChartElement.
public override void Refresh()
Overrides:
Validates the point.
Events
Occurs when a new DataPoint is created.
public event ChartViewCreatePointEventHandler CreatePoint
When the trackball is shown, this event is fired for every point that is being currently shown.
public event TrackballPointTextNeededEventHandler TrackballPointTextNeeded