Skip to end of metadata
Go to start of metadata

Represents a control that contains a dynamic data series.

Definition

public abstract class DataPointSeries : Series,

IZoomPanelHost, ISelectableSeries

Summary

The following table summarizes the members exposed in this class.

Protected Constructors

DataPointSeries Constructor() Initializes a new instance of the DataPointSeries class.

Public Properties

AnimationSequence Gets or sets the animation sequence to use for the DataPoints of the Series.
AnimationSequenceDuration Gets or sets the animation sequence duration to use for the DataPoints of the Series.
BorderStyle Gets or sets style of border
CanUserSelect Gets or sets a value indicating whether elements in the series can be selected.
DataLabelAngle Gets or sets angle for data label
DataLabelConnectorLength Gets or sets length for connector of data label
DataLabelConnectorVisibility Gets or sets visibility for connector of data label
DataLabelStyle Gets or sets a style of Data Label used by the series.
DataLabelVisibility Gets or sets visibility for data label
DataPointStyle Gets or sets the style to use for the data points.
DataPointStyleSelector Gets or sets the style selector to use for the data points.
DependentValueBinding Gets or sets the Binding to use for identifying the dependent value.
DependentValuePath Gets or sets the Binding Path to use for identifying the dependent value.
EnableFadingAnimation Gets or sets value for enabling animation fading
EnableHighlightNearestDataPoint Gets or sets a value that determines whether to enable highlight nearest data point
EnableValueAnimation Gets or sets a value that determines whether to enable value animation
HighlightedDataPoint Gets or sets a object data point that been highlighted
IndependentValueBinding Gets or sets the Binding to use for identifying the independent value.
IndependentValuePath Gets or sets the Binding Path to use for identifying the independent value.
ItemsSource Gets or sets a collection used to contain the data points of the Series.
LegendItemStyle Gets or sets the style to use for the legend items.
SelectedItem Gets or sets the selected item.
SelectedItems Gets or sets a value that indicates the SelectedItems
ToolTipHorizontalOffset Gets or sets a value that indicates the ToolTipHorizontalOffset
ToolTipPosition Gets or sets the preferred tooltip position.
ToolTipTemplate Gets or sets the template of the data point tooltip
ToolTipVerticalOffset Gets or sets a value that indicates the ToolTipVerticalOffset
TransitionDuration Gets or sets the duration of the value Transition animation.
TransitionEasingFunction Gets or sets a value that indicates the TransitionEasingFunction

Protected Properties

ActiveDataPointCount Gets the number of active data points in the plot area.
PlotAreaSize Gets the size of the plot area.
UpdatingDataPoints Gets a value indicating whether all data points are being updated.

Fields

AnimationSequenceDurationProperty Identifies the AnimationSequenceDuration dependency property.
AnimationSequenceProperty Identifies the AnimationSequence dependency property.
BorderStyleProperty Identifies the BorderStyle dependency property.
CanUserSelectProperty Identifies the CanUserSelect dependency property.
DataLabelAngleProperty Identifies the DataLabelAngle dependency property.
DataLabelConnectorLengthProperty Identifies the DataLabelAngle dependency property.
DataLabelConnectorVisibilityProperty Identifies the DataLabelConnectorVisibility dependency property.
DataLabelStyleProperty Identifies the DataLabelStyle dependency property.
DataLabelVisibilityProperty Identifies the DataLabelVisibility dependency property.
DataPointStyleProperty Identifies the DataPointStyle dependency property.
DataPointStyleSelectorProperty Identifies the DataPointStyleSelector dependency property.
EnableFadingAnimationProperty Identifies the EnableFadingAnimation dependency property.
EnableHighlightNearestDataPointProperty Identifies the EnableHighlightNearestDataPoint dependency property.
EnableValueAnimationProperty Identifies the EnableValueAnimation dependency property.
HighlightedDataPointProperty Identifies the HighlightedDataPoint dependency property.
ItemsSourceProperty Identifies the ItemsSource dependency property.
LegendItemStyleProperty Identifies the LegendItemStyle dependency property.
SelectedItemProperty Identifies the SelectedItem dependency property.
SelectedItemsProperty Identifies the SelectedItems dependency property.
ToolTipHorizontalOffsetProperty Identifies the ToolTipHorizontalOffset dependency property.
ToolTipPositionProperty Identifies the ToolTipPosition dependency property.
ToolTipTemplateProperty Identifies the ToolTipTemplate dependency property.
ToolTipVerticalOffsetProperty Identifies the ToolTipVerticalOffset dependency property.
TransitionDurationProperty Identifies the TransitionDuration dependency property.
TransitionEasingFunctionProperty Identifies the TransitionEasingFunction dependency property.

Public Methods

AttachEventHandlers() Attach built-in event handlers to control templates. Call this method if necessary.
DetachedEventHandlers() Detach built-in event handlers from control templates. Call this method if necessary.
InitializeTemplates() Initializes control templates.
OnApplyTemplate() Builds the visual tree for the ISItemsControl when a new template is applied.
Refresh() Refreshes data from data source and renders the series.

Protected Methods

AddDataPoint(DataPoint) Adds a data point to the plot area.
AddObject(object) Adds an object to the series host by creating a corresponding data point for it.
AttachEventHandlersToDataPoint(IDataPoint) Attaches event handlers to a data point.
CreateDataPoint() Returns a Control suitable for the Series.
CreateLegendItem(DataPointSeries) Creates a legend item.
DetachEventHandlersFromDataPoint(IDataPoint) Detaches event handlers from a data point.
GetDataPoint(object) Retrieves the data point corresponding to the object passed as the parameter.
GetInsertionIndex(DataPoint) Returns the index at which to insert data point in the plot area child collection.
LoadDataPoints(IEnumerable, IEnumerable) Updates data points collection with items retrieved from items source and removes the old items.
OnAfterUpdateDataPoints() This method that executes after data points are updated.
OnBeforeUpdateDataPoints() This method that executes before data points are updated.
OnCanUserSelectPropertyChanged(bool, bool) CanUserSelectProperty property changed handler.
OnDataLabelPropertyChanged() DataLabelProperty property changed handler.
OnDataPointActualDependentValueChanged(IDataPoint, IComparable, IComparable) Handles data point actual dependent value property change.
OnDataPointActualIndependentValueChanged(IDataPoint, object, object) Handles data point actual independent value property change.
OnDataPointDependentValueChanged(IDataPoint, IComparable, IComparable) Handles data point dependent value property change.
OnDataPointIndependentValueChanged(IDataPoint, object, object) Handles data point independent value property change.
OnDataPointsChanged(IList<IDataPoint>, IList<IDataPoint>) Called after data points have been loaded from the items source.
OnDataPointStateChanged(DataPoint, DataPointState, DataPointState) Handles data point state property change.
OnDataPointStylePropertyChanged(Style, Style) DataPointStyleProperty property changed handler.
OnItemsSourceChanged(IEnumerable, IEnumerable) ItemsSource property changed handler.
OnItemsSourceCollectionChanged(IEnumerable, NotifyCollectionChangedEventArgs) Method called when the ItemsSource collection changes.
OnLegendItemStylePropertyChanged(Style, Style) LegendItemStyleProperty property changed handler.
OnPlotAreaChanged(Panel, Panel) Removes items from the existing plot area and adds items to new plot area.
OnSelectedItemPropertyChanged(object, object) SelectedItemProperty property changed handler.
OnSeriesHostPropertyChanged(ISeriesHost, ISeriesHost) Handles changes to the SeriesHost property.
OnSizeChanged() Occur when size changed
PrepareDataPoint(DataPoint, object) Prepares a data point by extracting binding it to a data context object.
RemoveDataPoint(DataPoint) Removes a data point from the plot area.
RemoveObject(object) Removes an object from the series host by removing its corresponding data point.
ShouldCreateDataPoint(object) Returns whether a data point should be created for the data context.
UpdateDataPoint(IDataPoint) Updates the visual representation of a single data point in the plot area.
UpdateDataPoints(IEnumerable<IDataPoint>) Updates the visual representation of all data points in the plot area.

Events

SelectionChanged Occurs when the selection of a DefinitionSeries changes.

Protected Constructors

protected DataPointSeries()

Initializes a new instance of the DataPointSeries class.

Public Properties

public AnimationSequence AnimationSequence { get; set; }

Gets or sets the animation sequence to use for the DataPoints of the Series.

public double AnimationSequenceDuration { get; set; }

Gets or sets the animation sequence duration to use for the DataPoints of the Series.

public BorderStyle BorderStyle { get; set; }

Gets or sets style of border

public bool CanUserSelect { get; set; }

Gets or sets a value indicating whether elements in the series can be selected.

public double DataLabelAngle { get; set; }

Gets or sets angle for data label

public double DataLabelConnectorLength { get; set; }

Gets or sets length for connector of data label

public Visibility DataLabelConnectorVisibility { get; set; }

Gets or sets visibility for connector of data label

public Style DataLabelStyle { get; set; }

Gets or sets a style of Data Label used by the series.

public Visibility DataLabelVisibility { get; set; }

Gets or sets visibility for data label

public Style DataPointStyle { get; set; }

Gets or sets the style to use for the data points.

public StyleSelector DataPointStyleSelector { get; set; }

Gets or sets the style selector to use for the data points.

public Binding DependentValueBinding { get; set; }

Gets or sets the Binding to use for identifying the dependent value.

public string DependentValuePath { get; set; }

Gets or sets the Binding Path to use for identifying the dependent value.

public bool EnableFadingAnimation { get; set; }

Gets or sets value for enabling animation fading

public bool EnableHighlightNearestDataPoint { get; set; }

Gets or sets a value that determines whether to enable highlight nearest data point

public bool EnableValueAnimation { get; set; }

Gets or sets a value that determines whether to enable value animation

public object HighlightedDataPoint { get; set; }

Gets or sets a object data point that been highlighted

public Binding IndependentValueBinding { get; set; }

Gets or sets the Binding to use for identifying the independent value.

public string IndependentValuePath { get; set; }

Gets or sets the Binding Path to use for identifying the independent value.

public IEnumerable ItemsSource { get; set; }

Gets or sets a collection used to contain the data points of the Series.

public Style LegendItemStyle { get; set; }

Gets or sets the style to use for the legend items.

public object SelectedItem { get; set; }

Gets or sets the selected item.

public INotifyCollectionChanged SelectedItems { get; set; }

Gets or sets a value that indicates the SelectedItems

public double ToolTipHorizontalOffset { get; set; }

Gets or sets a value that indicates the ToolTipHorizontalOffset

public PopupPosition ToolTipPosition { get; set; }

Gets or sets the preferred tooltip position.

public DataTemplate ToolTipTemplate { get; set; }

Gets or sets the template of the data point tooltip

public double ToolTipVerticalOffset { get; set; }

Gets or sets a value that indicates the ToolTipVerticalOffset

public TimeSpan TransitionDuration { get; set; }

Gets or sets the duration of the value Transition animation.

public IEasingFunction TransitionEasingFunction { get; set; }

Gets or sets a value that indicates the TransitionEasingFunction

Protected Properties

protected int ActiveDataPointCount { get; }

Gets the number of active data points in the plot area.

protected Size PlotAreaSize { get; }

Gets the size of the plot area.

Remarks

Use this method instead of PlotArea.ActualWidth/ActualHeight because the ActualWidth and ActualHeight properties are set after the SizeChanged handler runs.

protected bool UpdatingDataPoints { get; }

Gets a value indicating whether all data points are being updated.

Fields

public static readonly DependencyProperty AnimationSequenceDurationProperty

Identifies the AnimationSequenceDuration dependency property.

public static readonly DependencyProperty AnimationSequenceProperty

Identifies the AnimationSequence dependency property.

public static readonly DependencyProperty BorderStyleProperty

Identifies the BorderStyle dependency property.

public static readonly DependencyProperty CanUserSelectProperty

Identifies the CanUserSelect dependency property.

public static readonly DependencyProperty DataLabelAngleProperty

Identifies the DataLabelAngle dependency property.

public static readonly DependencyProperty DataLabelConnectorLengthProperty

Identifies the DataLabelAngle dependency property.

public static readonly DependencyProperty DataLabelConnectorVisibilityProperty

Identifies the DataLabelConnectorVisibility dependency property.

public static readonly DependencyProperty DataLabelStyleProperty

Identifies the DataLabelStyle dependency property.

public static readonly DependencyProperty DataLabelVisibilityProperty

Identifies the DataLabelVisibility dependency property.

public static readonly DependencyProperty DataPointStyleProperty

Identifies the DataPointStyle dependency property.

public static readonly DependencyProperty DataPointStyleSelectorProperty

Identifies the DataPointStyleSelector dependency property.

public static readonly DependencyProperty EnableFadingAnimationProperty

Identifies the EnableFadingAnimation dependency property.

public static readonly DependencyProperty EnableHighlightNearestDataPointProperty

Identifies the EnableHighlightNearestDataPoint dependency property.

public static readonly DependencyProperty EnableValueAnimationProperty

Identifies the EnableValueAnimation dependency property.

public static readonly DependencyProperty HighlightedDataPointProperty

Identifies the HighlightedDataPoint dependency property.

public static readonly DependencyProperty ItemsSourceProperty

Identifies the ItemsSource dependency property.

public static readonly DependencyProperty LegendItemStyleProperty

Identifies the LegendItemStyle dependency property.

public static readonly DependencyProperty SelectedItemProperty

Identifies the SelectedItem dependency property.

public static readonly DependencyProperty SelectedItemsProperty

Identifies the SelectedItems dependency property.

public static readonly DependencyProperty ToolTipHorizontalOffsetProperty

Identifies the ToolTipHorizontalOffset dependency property.

public static readonly DependencyProperty ToolTipPositionProperty

Identifies the ToolTipPosition dependency property.

public static readonly DependencyProperty ToolTipTemplateProperty

Identifies the ToolTipTemplate dependency property.

public static readonly DependencyProperty ToolTipVerticalOffsetProperty

Identifies the ToolTipVerticalOffset dependency property.

public static readonly DependencyProperty TransitionDurationProperty

Identifies the TransitionDuration dependency property.

public static readonly DependencyProperty TransitionEasingFunctionProperty

Identifies the TransitionEasingFunction dependency property.

Public Methods

public void AttachEventHandlers()

Attach built-in event handlers to control templates. Call this method if necessary.

public void DetachedEventHandlers()

Detach built-in event handlers from control templates. Call this method if necessary.

public void InitializeTemplates()

Initializes control templates.

public void OnApplyTemplate()

Builds the visual tree for the ISItemsControl when a new template is applied.

public void Refresh()

Refreshes data from data source and renders the series.

Protected Methods

protected void AddDataPoint(DataPoint dataPoint)

Adds a data point to the plot area.

Parameters

dataPoint The data point to add to the plot area.

protected IDataPoint AddObject(object dataContext)

Adds an object to the series host by creating a corresponding data point for it.

Parameters

dataContext The object to add to the series host.

Return Types

The data point created for the object.

protected void AttachEventHandlersToDataPoint(IDataPoint dataPoint)

Attaches event handlers to a data point.

Parameters

dataPoint The data point.

protected DataPoint CreateDataPoint()

Returns a Control suitable for the Series.

Return Types

The DataPoint instance.

protected LegendItem CreateLegendItem(DataPointSeries owner)

Creates a legend item.

Parameters

owner The owner of the new LegendItem.

Return Types

A legend item for insertion in the legend items collection.

protected void DetachEventHandlersFromDataPoint(IDataPoint dataPoint)

Detaches event handlers from a data point.

Parameters

dataPoint The data point.

protected IDataPoint GetDataPoint(object dataContext)

Retrieves the data point corresponding to the object passed as the parameter.

Parameters

dataContext The data context used for the point.

Return Types

The data point associated with the object.

protected int GetInsertionIndex(DataPoint dataPoint)

Returns the index at which to insert data point in the plot area child collection.

Parameters

dataPoint The data point to retrieve the insertion index for.

Return Types

The insertion index.

protected void LoadDataPoints(IEnumerable newItems, IEnumerable oldItems)

Updates data points collection with items retrieved from items source and removes the old items.

Parameters

newItems The items to load.
oldItems The items to remove.

protected void OnAfterUpdateDataPoints()

This method that executes after data points are updated.

protected void OnBeforeUpdateDataPoints()

This method that executes before data points are updated.

protected void OnCanUserSelectPropertyChanged(bool oldValue, bool newValue)

CanUserSelectProperty property changed handler.

Parameters

oldValue old value
newValue new value

protected void OnDataLabelPropertyChanged()

DataLabelProperty property changed handler.

protected void OnDataPointActualDependentValueChanged(IDataPoint dataPoint, IComparable oldValue, IComparable newValue)

Handles data point actual dependent value property change.

Parameters

dataPoint The data point.
oldValue The old value.
newValue The new value.

protected void OnDataPointActualIndependentValueChanged(IDataPoint dataPoint, object oldValue, object newValue)

Handles data point actual independent value property change.

Parameters

dataPoint The data point.
oldValue The old value.
newValue The new value.

protected void OnDataPointDependentValueChanged(IDataPoint dataPoint, IComparable oldValue, IComparable newValue)

Handles data point dependent value property change.

Parameters

dataPoint The data point.
oldValue The old value.
newValue The new value.

protected void OnDataPointIndependentValueChanged(IDataPoint dataPoint, object oldValue, object newValue)

Handles data point independent value property change.

Parameters

dataPoint The data point.
oldValue The old value.
newValue The new value.

protected void OnDataPointsChanged(IList<IDataPoint> newDataPoints, IList<IDataPoint> oldDataPoints)

Called after data points have been loaded from the items source.

Parameters

newDataPoints New active data points.
oldDataPoints Old inactive data points.

protected void OnDataPointStateChanged(DataPoint dataPoint, DataPointState oldValue, DataPointState newValue)

Handles data point state property change.

Parameters

dataPoint The data point.
oldValue The old value.
newValue The new value.

protected void OnDataPointStylePropertyChanged(Style oldValue, Style newValue)

DataPointStyleProperty property changed handler.

Parameters

oldValue
newValue

protected void OnItemsSourceChanged(IEnumerable oldValue, IEnumerable newValue)

ItemsSource property changed handler.

Parameters

oldValue old item source
newValue new item source

protected void OnItemsSourceCollectionChanged(IEnumerable collection, NotifyCollectionChangedEventArgs e)

Method called when the ItemsSource collection changes.

Parameters

collection New value of the collection.
e Information about the change.

protected void OnLegendItemStylePropertyChanged(Style oldValue, Style newValue)

LegendItemStyleProperty property changed handler.

Parameters

oldValue old style
newValue new style

protected void OnPlotAreaChanged(Panel oldValue, Panel newValue)

Removes items from the existing plot area and adds items to new plot area.

Parameters

oldValue The previous plot area.
newValue The new plot area.

protected void OnSelectedItemPropertyChanged(object oldValue, object newValue)

SelectedItemProperty property changed handler.

Parameters

oldValue previous selected item
newValue new selected item

protected void OnSeriesHostPropertyChanged(ISeriesHost oldValue, ISeriesHost newValue)

Handles changes to the SeriesHost property.

Parameters

oldValue Old value.
newValue New value.

protected void OnSizeChanged()

Occur when size changed

protected void PrepareDataPoint(DataPoint dataPoint, object dataContext)

Prepares a data point by extracting binding it to a data context object.

Parameters

dataPoint A data point.
dataContext A data context object.

protected void RemoveDataPoint(DataPoint dataPoint)

Removes a data point from the plot area.

Parameters

dataPoint The data point to remove.

protected IDataPoint RemoveObject(object dataContext)

Removes an object from the series host by removing its corresponding data point.

Parameters

dataContext The object to remove from the series data source.

Return Types

The data point corresponding to the removed object.

protected bool ShouldCreateDataPoint(object dataContext)

Returns whether a data point should be created for the data context.

Parameters

dataContext The data context that will be used for the data point.

Return Types

A value indicating whether a data point should be created for the data context.

protected void UpdateDataPoint(IDataPoint dataPoint)

Updates the visual representation of a single data point in the plot area.

Parameters

dataPoint The data point to update.

protected void UpdateDataPoints(IEnumerable<IDataPoint> dataPoints)

Updates the visual representation of all data points in the plot area.

Parameters

dataPoints A sequence of data points to update.

Events

public event SelectionChangedEventHandler SelectionChanged

Occurs when the selection of a DefinitionSeries changes.

  • No labels