Remarks
Data point is set of data that consist information for your chart display, it can appear as small rectangle, bar, circle, or line. It usually have color to distinguish one set of data points from other series data points. By default, DataPoint uses color from the predefined collection of color palette. But you can override style from given palette by using custom palette.
Working with BorderStyle Property
In addition to customizing color palettes, you can also set the data point's border style by using BorderStyle property. There are three mode that you can choose.
- Emboss
Style to decorate with or as if with a raised design. - Flat
Style with a flat and borderless look. - Metro
Style with neat, modern and clean look.
To learn more how to customize the palette, see How-to: Add Custom Palettes in UXChart.
Definition
public abstract class DataPoint : ISControl, IDataPoint
Summary
The following table summarizes the members exposed in this class.
Protected Constructors
| DataPoint Constructor() | Initializes a new instance of the DataPoint class. |
Public Properties
| ActualDependentValue | Gets or sets the actual dependent value displayed in the chart. |
| ActualIndependentValue | Gets or sets the actual independent value displayed in the chart. |
| BorderStyle | Gets or sets a value that indicates the BorderStyle |
| CanUserSelect | Gets or sets a value indicating whether selection is enabled. |
| DataLabelAngle | Gets or sets a value indicating angle of data label |
| DataLabelConnectorLength | Gets or sets a value indicating length of data label connector |
| DataLabelConnectorVisibility | Gets or sets a value indicating visibility of data label connector |
| DataLabelVisibility | Gets or sets a value indicating visibility of data label |
| DependentValue | Gets or sets the dependent value of the Control. |
| DependentValueStringFormat | Gets or sets the format string for the FormattedDependentValue property. |
| FormattedDependentValue | Gets the DependentValue as formatted by the DependentValueStringFormat property. |
| FormattedIndependentValue | Gets the IndependentValue as formatted by the IndependentValueStringFormat property. |
| IndependentValue | Gets or sets the independent value. |
| IndependentValueStringFormat | Gets or sets the format string for the FormattedIndependentValue property. |
| Owner | Gets or sets owner of this data point |
Protected Properties
| Product | Product Info. |
Fields
| ActualDependentValueProperty | Identifies the ActualDependentValue dependency property. |
| ActualIndependentValueProperty | Identifies the ActualIndependentValue 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. |
| DataLabelVisibilityProperty | Identifies the DataLabelVisibility dependency property. |
| DependentValueProperty | Identifies the DependentValue dependency property. |
| DependentValueStringFormatProperty | Identifies the DependentValueStringFormat dependency property. |
| FormattedDependentValueProperty | Identifies the FormattedDependentValue dependency property. |
| FormattedIndependentValueProperty | Identifies the FormattedIndependentValue dependency property. |
| IndependentValueProperty | Identifies the IndependentValue dependency property. |
| IndependentValueStringFormatProperty | Identifies the IndependentValueStringFormat dependency property. |
Public Methods
| AttachEventHandlers() | Attach built-in event handlers to control templates. |
| 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 DataPoint when a new template is applied. |
Protected Methods
| OnActualDependentValuePropertyChanged(IComparable, IComparable) | Called when the value of the ActualDependentValue property changes. |
| OnActualIndependentValuePropertyChanged(object, object) | Called when the ActualIndependentValue property changes. |
| OnCanUserSelectPropertyChanged(bool, bool) | CanUserSelectProperty property changed handler. |
| OnDependentValuePropertyChanged(IComparable, IComparable) | Called when the DependentValue property changes. |
| OnDependentValueStringFormatPropertyChanged(string, string) | Called when DependentValueStringFormat property changes. |
| OnIndependentValuePropertyChanged(object, object) | Called when the IndependentValue property changes. |
| OnIndependentValueStringFormatPropertyChanged(string, string) | Called when the value of the IndependentValueStringFormat property changes. |
| OnIsHoveredPropertyChanged(bool, bool) | IsHoveredProperty property changed handler. |
| OnIsSelectedPropertyChanged(bool, bool) | IsSelectedProperty property changed handler. |
| OnMouseEnter(MouseEventArgs) | Provides handling for the MouseEnter event. |
| OnMouseLeave(MouseEventArgs) | Provides handling for the MouseLeave event. |
| OnMouseLeftButtonDown(MouseButtonEventArgs) | Provides handling for the MouseLeftButtonDown event. |
| OnStatePropertyChanged(DataPointState, DataPointState) | Called when the value of the State property changes. |
Events
| ActualDependentValueChanged | Event raised when the actual dependent value of the data point is changed. |
| ActualIndependentValueChanged | Occurs when the actual independent value of the data point is changed. |
| DependentValueChanged | This event is raised when the dependent value of the data point is changed. |
| IndependentValueChanged | Called when the independent value of the data point is changed. |
Protected Constructors
protected DataPoint()
Initializes a new instance of the DataPoint class.
Public Properties
public IComparable ActualDependentValue { get; set; }
Gets or sets the actual dependent value displayed in the chart.
public object ActualIndependentValue { get; set; }
Gets or sets the actual independent value displayed in the chart.
public BorderStyle BorderStyle { get; set; }
Gets or sets a value that indicates the BorderStyle
Remarks
| In addition to customizing color palettes, you can also set the data point's border style by using BorderStyle property. There are three mode that you can choose.EmbossStyle to decorate with or as if with a raised design. FlatStyle with a flat and borderless look. MetroStyle with neat, modern and clean look.To learn more how to customize the palette, see How-to: Add Custom Palettes in UXChart. |
public bool CanUserSelect { get; set; }
Gets or sets a value indicating whether selection is enabled.
public double DataLabelAngle { get; set; }
Gets or sets a value indicating angle of data label
public double DataLabelConnectorLength { get; set; }
Gets or sets a value indicating length of data label connector
public Visibility DataLabelConnectorVisibility { get; set; }
Gets or sets a value indicating visibility of data label connector
public Visibility DataLabelVisibility { get; set; }
Gets or sets a value indicating visibility of data label
public IComparable DependentValue { get; set; }
Gets or sets the dependent value of the Control.
public string DependentValueStringFormat { get; set; }
Gets or sets the format string for the FormattedDependentValue property.
public string FormattedDependentValue { get; }
Gets the DependentValue as formatted by the DependentValueStringFormat property.
public string FormattedIndependentValue { get; }
Gets the IndependentValue as formatted by the IndependentValueStringFormat property.
public object IndependentValue { get; set; }
Gets or sets the independent value.
public string IndependentValueStringFormat { get; set; }
Gets or sets the format string for the FormattedIndependentValue property.
public ISeries Owner { get; }
Gets or sets owner of this data point
Protected Properties
protected ProductInfo Product { get; }
Product Info.
Fields
public static readonly DependencyProperty ActualDependentValueProperty
Identifies the ActualDependentValue dependency property.
public static readonly DependencyProperty ActualIndependentValueProperty
Identifies the ActualIndependentValue 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 DataLabelVisibilityProperty
Identifies the DataLabelVisibility dependency property.
public static readonly DependencyProperty DependentValueProperty
Identifies the DependentValue dependency property.
public static readonly DependencyProperty DependentValueStringFormatProperty
Identifies the DependentValueStringFormat dependency property.
public static readonly DependencyProperty FormattedDependentValueProperty
Identifies the FormattedDependentValue dependency property.
public static readonly DependencyProperty FormattedIndependentValueProperty
Identifies the FormattedIndependentValue dependency property.
public static readonly DependencyProperty IndependentValueProperty
Identifies the IndependentValue dependency property.
public static readonly DependencyProperty IndependentValueStringFormatProperty
Identifies the IndependentValueStringFormat dependency property.
Public Methods
public void AttachEventHandlers()
Attach built-in event handlers to control templates.
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 DataPoint when a new template is applied.
Protected Methods
protected void OnActualDependentValuePropertyChanged(IComparable oldValue, IComparable newValue)
Called when the value of the ActualDependentValue property changes.
Parameters
| oldValue | The value to be replaced. |
| newValue | The new value. |
protected void OnActualIndependentValuePropertyChanged(object oldValue, object newValue)
Called when the ActualIndependentValue property changes.
Parameters
| oldValue | The value to be replaced. |
| newValue | The new value. |
protected void OnCanUserSelectPropertyChanged(bool oldValue, bool newValue)
CanUserSelectProperty property changed handler.
Parameters
| oldValue | Old value. |
| newValue | New value. |
protected void OnDependentValuePropertyChanged(IComparable oldValue, IComparable newValue)
Called when the DependentValue property changes.
Parameters
| oldValue | The value to be replaced. |
| newValue | The new value. |
protected void OnDependentValueStringFormatPropertyChanged(string oldValue, string newValue)
Called when DependentValueStringFormat property changes.
Parameters
| oldValue | The value to be replaced. |
| newValue | The new value. |
protected void OnIndependentValuePropertyChanged(object oldValue, object newValue)
Called when the IndependentValue property changes.
Parameters
| oldValue | The old value. |
| newValue | The new value. |
protected void OnIndependentValueStringFormatPropertyChanged(string oldValue, string newValue)
Called when the value of the IndependentValueStringFormat property changes.
Parameters
| oldValue | The value to be replaced. |
| newValue | The new value. |
protected void OnIsHoveredPropertyChanged(bool oldValue, bool newValue)
IsHoveredProperty property changed handler.
Parameters
| oldValue | Old value. |
| newValue | New value. |
protected void OnIsSelectedPropertyChanged(bool oldValue, bool newValue)
IsSelectedProperty property changed handler.
Parameters
| oldValue | The value to be replaced. |
| newValue | The new value. |
protected void OnMouseEnter(MouseEventArgs e)
Provides handling for the MouseEnter event.
Parameters
| e | Event arguments. |
protected void OnMouseLeave(MouseEventArgs e)
Provides handling for the MouseLeave event.
Parameters
| e | Event arguments. |
protected void OnMouseLeftButtonDown(MouseButtonEventArgs e)
Provides handling for the MouseLeftButtonDown event.
Parameters
| e | Event arguments. |
protected void OnStatePropertyChanged(DataPointState oldValue, DataPointState newValue)
Called when the value of the State property changes.
Parameters
| oldValue | The value to be replaced. |
| newValue | The new value. |
Events
public event RoutedPropertyChangedEventHandler<IComparable> ActualDependentValueChanged
Event raised when the actual dependent value of the data point is changed.
public event RoutedPropertyChangedEventHandler<object> ActualIndependentValueChanged
Occurs when the actual independent value of the data point is changed.
public event RoutedPropertyChangedEventHandler<IComparable> DependentValueChanged
This event is raised when the dependent value of the data point is changed.
public event RoutedPropertyChangedEventHandler<object> IndependentValueChanged
Called when the independent value of the data point is changed.