DataPoint DataPoint DataPoint DataPoint Class

Definition

Represents a data point that is stored in the DataPointCollection class.

public ref class DataPoint : System::Windows::Forms::DataVisualization::Charting::DataPointCustomProperties
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataVisualization.Charting.DataPointConverter, System.Windows.Forms.DataVisualization.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35")]
public class DataPoint : System.Windows.Forms.DataVisualization.Charting.DataPointCustomProperties
type DataPoint = class
    inherit DataPointCustomProperties
Public Class DataPoint
Inherits DataPointCustomProperties
Inheritance
Attributes

Remarks

The DataPoint class stores properties associated with data as well as data point values. For example, a data point has a value, but it also has a color property, background image property, background gradient property, and so forth. For more information about data point properties, see the DataPointCustomProperties class overview topic.

Each data point consists of an X-value and one or more Y-values. The X-value can be zero, or you can set this explicitly.

Only one Y-value per point is required for all chart types except bubble, candlestick and stock charts. These chart types require more than one Y-value because one data point consists of multiple values. For example, to plot one stock chart column, four values are required: high, low, open and close values.

Data can be added at either design time or run time; you can also use data-binding at run time.

Constructors

DataPoint() DataPoint() DataPoint() DataPoint()

Initializes a new instance of the DataPoint class.

DataPoint(Double, Double) DataPoint(Double, Double) DataPoint(Double, Double) DataPoint(Double, Double)

Initializes a new instance of the DataPoint class with the specified X and Y-value.

DataPoint(Double, Double[]) DataPoint(Double, Double[]) DataPoint(Double, Double[]) DataPoint(Double, Double[])

Initializes a new instance of the DataPoint class with the specified X-value and an array of Y-values.

DataPoint(Double, String) DataPoint(Double, String) DataPoint(Double, String) DataPoint(Double, String)

Initializes a new instance of the DataPoint class with the specified X-value and Y-values.

DataPoint(Series) DataPoint(Series) DataPoint(Series) DataPoint(Series)

Initializes a new instance of the DataPoint class, and sets the Series that the data point belongs to.

Properties

AxisLabel AxisLabel AxisLabel AxisLabel

Gets or sets the text of the X-axis label for the data point, series or an empty point. This property is only used if a custom label has not been specified for the relevant Axis object.

(Inherited from DataPointCustomProperties)
BackGradientStyle BackGradientStyle BackGradientStyle BackGradientStyle

Gets or sets the background gradient style.

(Inherited from DataPointCustomProperties)
BackHatchStyle BackHatchStyle BackHatchStyle BackHatchStyle

Gets or sets the background hatching style.

(Inherited from DataPointCustomProperties)
BackImage BackImage BackImage BackImage

Gets or sets the background image of the data point.

(Inherited from DataPointCustomProperties)
BackImageAlignment BackImageAlignment BackImageAlignment BackImageAlignment

Gets or sets the alignment of the background image, which is used with the Unscaled drawing mode.

(Inherited from DataPointCustomProperties)
BackImageTransparentColor BackImageTransparentColor BackImageTransparentColor BackImageTransparentColor

Gets or sets a color that will be replaced with a transparent color when the background image is drawn.

(Inherited from DataPointCustomProperties)
BackImageWrapMode BackImageWrapMode BackImageWrapMode BackImageWrapMode

Gets or sets the drawing mode of the background image.

(Inherited from DataPointCustomProperties)
BackSecondaryColor BackSecondaryColor BackSecondaryColor BackSecondaryColor

Gets or sets the secondary background color.

(Inherited from DataPointCustomProperties)
BorderColor BorderColor BorderColor BorderColor

Gets or sets the border color of the data point.

(Inherited from DataPointCustomProperties)
BorderDashStyle BorderDashStyle BorderDashStyle BorderDashStyle

Gets or sets the border style of the data point.

(Inherited from DataPointCustomProperties)
BorderWidth BorderWidth BorderWidth BorderWidth

Gets or sets the border width of the data point.

(Inherited from DataPointCustomProperties)
Color Color Color Color

Gets or sets the color of the data point.

(Inherited from DataPointCustomProperties)
CustomProperties CustomProperties CustomProperties CustomProperties

Gets or sets the custom properties of the data point. Custom properties can be specified in the following format: AttrName1=Value1, AttrName2=Value2 …

(Inherited from DataPointCustomProperties)
CustomPropertiesExtended CustomPropertiesExtended CustomPropertiesExtended CustomPropertiesExtended

Gets or sets the extended custom properties of the data point. Extended custom properties can be specified in the following format: AttrName1=Value1, AttrName2=Value2...

(Inherited from DataPointCustomProperties)
Font Font Font Font

Gets or sets the font of the data point.

(Inherited from DataPointCustomProperties)
IsEmpty IsEmpty IsEmpty IsEmpty

Gets or sets a flag that indicates whether a data point is marked as empty.

IsValueShownAsLabel IsValueShownAsLabel IsValueShownAsLabel IsValueShownAsLabel

Gets or sets a flag that indicates whether to show the value of the data point on the label.

(Inherited from DataPointCustomProperties)
IsVisibleInLegend IsVisibleInLegend IsVisibleInLegend IsVisibleInLegend

Gets or sets a flag that indicates whether the item is shown in the legend.

(Inherited from DataPointCustomProperties)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Gets the DataPointCustomProperties object by its position in the index.

(Inherited from DataPointCustomProperties)
Item[String] Item[String] Item[String] Item[String]

Gets or sets the DataPointCustomProperties object by name.

(Inherited from DataPointCustomProperties)
Label Label Label Label

Gets or sets the text of the data point label.

(Inherited from DataPointCustomProperties)
LabelAngle LabelAngle LabelAngle LabelAngle

Gets or sets the angle of the data point label.

(Inherited from DataPointCustomProperties)
LabelBackColor LabelBackColor LabelBackColor LabelBackColor

Gets or sets the background color of the data point label.

(Inherited from DataPointCustomProperties)
LabelBorderColor LabelBorderColor LabelBorderColor LabelBorderColor

Gets or sets the border color of the data point label.

(Inherited from DataPointCustomProperties)
LabelBorderDashStyle LabelBorderDashStyle LabelBorderDashStyle LabelBorderDashStyle

Gets or sets the border style of the label.

(Inherited from DataPointCustomProperties)
LabelBorderWidth LabelBorderWidth LabelBorderWidth LabelBorderWidth

Gets or sets the border width of the label.

(Inherited from DataPointCustomProperties)
LabelForeColor LabelForeColor LabelForeColor LabelForeColor

Gets or sets the text color of the label.

(Inherited from DataPointCustomProperties)
LabelFormat LabelFormat LabelFormat LabelFormat

Gets or sets the format of the data point label.

(Inherited from DataPointCustomProperties)
LabelToolTip LabelToolTip LabelToolTip LabelToolTip

Gets or sets the tooltip for the data point label.

(Inherited from DataPointCustomProperties)
LegendText LegendText LegendText LegendText

Gets or sets the text of the item in the legend.

(Inherited from DataPointCustomProperties)
LegendToolTip LegendToolTip LegendToolTip LegendToolTip

Gets or sets the tooltip of the item in the legend.

(Inherited from DataPointCustomProperties)
MarkerBorderColor MarkerBorderColor MarkerBorderColor MarkerBorderColor

Gets or sets the border color of the marker.

(Inherited from DataPointCustomProperties)
MarkerBorderWidth MarkerBorderWidth MarkerBorderWidth MarkerBorderWidth

Gets or sets the border width of the marker.

(Inherited from DataPointCustomProperties)
MarkerColor MarkerColor MarkerColor MarkerColor

Gets or sets the marker color.

(Inherited from DataPointCustomProperties)
MarkerImage MarkerImage MarkerImage MarkerImage

Gets or sets the marker image.

(Inherited from DataPointCustomProperties)
MarkerImageTransparentColor MarkerImageTransparentColor MarkerImageTransparentColor MarkerImageTransparentColor

Gets or sets the color that will be replaced with a transparent color when the marker image is drawn.

(Inherited from DataPointCustomProperties)
MarkerSize MarkerSize MarkerSize MarkerSize

Gets or sets the size of the marker.

(Inherited from DataPointCustomProperties)
MarkerStyle MarkerStyle MarkerStyle MarkerStyle

Gets or sets the marker style.

(Inherited from DataPointCustomProperties)
Name Name Name Name

Gets or sets the name of the data point.

Tag Tag Tag Tag

Gets or sets an object associated with this chart element.

(Inherited from ChartElement)
ToolTip ToolTip ToolTip ToolTip

Gets or sets the tooltip.

(Inherited from DataPointCustomProperties)
XValue XValue XValue XValue

Gets or sets the X-value of a data point.

YValues YValues YValues YValues

Gets or sets the Y-value(s) of a data point.

Methods

Clone() Clone() Clone() Clone()

Returns a new instance that is an exact copy of the data point.

DeleteCustomProperty(String) DeleteCustomProperty(String) DeleteCustomProperty(String) DeleteCustomProperty(String)

Deletes the data point custom property with the specified name.

(Inherited from DataPointCustomProperties)
Dispose() Dispose() Dispose() Dispose()

Releases the resources used by the ChartElement.

(Inherited from ChartElement)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Releases the unmanaged resources used by the ChartElement and optionally releases the managed resources.

(Inherited from ChartElement)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determines whether the specified Object is equal to the current ChartElement.

(Inherited from ChartElement)
GetCustomProperty(String) GetCustomProperty(String) GetCustomProperty(String) GetCustomProperty(String)

Returns the data point custom property with the specified name.

(Inherited from DataPointCustomProperties)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Returns a hash function for a particular type.

(Inherited from ChartElement)
GetType() GetType() GetType() GetType()

Gets the Type of the current instance.

(Inherited from Object)
GetValueByName(String) GetValueByName(String) GetValueByName(String) GetValueByName(String)

Returns a data point that is specified by its name. This is a helper function.

IsCustomPropertySet(String) IsCustomPropertySet(String) IsCustomPropertySet(String) IsCustomPropertySet(String)

Determines whether a custom property with the specified name was set.

(Inherited from DataPointCustomProperties)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ResetIsValueShownAsLabel() ResetIsValueShownAsLabel() ResetIsValueShownAsLabel() ResetIsValueShownAsLabel()

Resets a custom property to its default value.

(Inherited from DataPointCustomProperties)
ResetIsVisibleInLegend() ResetIsVisibleInLegend() ResetIsVisibleInLegend() ResetIsVisibleInLegend()

Resets a custom property to its default value.

(Inherited from DataPointCustomProperties)
SetCustomProperty(String, String) SetCustomProperty(String, String) SetCustomProperty(String, String) SetCustomProperty(String, String)

Sets a custom property of the data point.

(Inherited from DataPointCustomProperties)
SetDefault(Boolean) SetDefault(Boolean) SetDefault(Boolean) SetDefault(Boolean)

Sets the default properties of the data point. Indicates whether the previous property values must be cleared.

(Inherited from DataPointCustomProperties)
SetValueXY(Object, Object[]) SetValueXY(Object, Object[]) SetValueXY(Object, Object[]) SetValueXY(Object, Object[])

Sets the X-value and one or more Y-values of the data point.

SetValueY(Object[]) SetValueY(Object[]) SetValueY(Object[]) SetValueY(Object[])

Sets the Y-value(s) of a single data point.

ToString() ToString() ToString() ToString()

Returns a string that represents the current Object.

(Inherited from ChartElement)

Applies to