DataPoint Class
Represents a data point that is stored in the DataPointCollection class.
Assembly: System.Windows.Forms.DataVisualization (in System.Windows.Forms.DataVisualization.dll)
System.Windows.Forms.DataVisualization.Charting::ChartElement
System.Windows.Forms.DataVisualization.Charting::ChartNamedElement
System.Windows.Forms.DataVisualization.Charting::DataPointCustomProperties
System.Windows.Forms.DataVisualization.Charting::DataPoint
| Name | Description | |
|---|---|---|
![]() | DataPoint() | Initializes a new instance of the DataPoint class. |
![]() | DataPoint(Double, Double) | Initializes a new instance of the DataPoint class with the specified X and Y-value. |
![]() | DataPoint(Double, array<Double>^) | Initializes a new instance of the DataPoint class with the specified X-value and an array of Y-values. |
![]() | DataPoint(Double, String^) | Initializes a new instance of the DataPoint class with the specified X-value and Y-values. |
![]() | DataPoint(Series^) | Initializes a new instance of the DataPoint class, and sets the Series that the data point belongs to. |
| Name | Description | |
|---|---|---|
![]() | 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 | Gets or sets the background gradient style.(Inherited from DataPointCustomProperties.) |
![]() | BackHatchStyle | Gets or sets the background hatching style.(Inherited from DataPointCustomProperties.) |
![]() | BackImage | Gets or sets the background image of the data point.(Inherited from DataPointCustomProperties.) |
![]() | BackImageAlignment | Gets or sets the alignment of the background image, which is used with the Unscaled drawing mode.(Inherited from DataPointCustomProperties.) |
![]() | BackImageTransparentColor | Gets or sets a color that will be replaced with a transparent color when the background image is drawn.(Inherited from DataPointCustomProperties.) |
![]() | BackImageWrapMode | Gets or sets the drawing mode of the background image.(Inherited from DataPointCustomProperties.) |
![]() | BackSecondaryColor | Gets or sets the secondary background color.(Inherited from DataPointCustomProperties.) |
![]() | BorderColor | Gets or sets the border color of the data point.(Inherited from DataPointCustomProperties.) |
![]() | BorderDashStyle | Gets or sets the border style of the data point.(Inherited from DataPointCustomProperties.) |
![]() | BorderWidth | Gets or sets the border width of the data point.(Inherited from DataPointCustomProperties.) |
![]() | Color | Gets or sets the color of the data point.(Inherited from DataPointCustomProperties.) |
![]() | 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 | 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 | Gets or sets the font of the data point.(Inherited from DataPointCustomProperties.) |
![]() | IsEmpty | Gets or sets a flag that indicates whether a data point is marked as empty. |
![]() | IsValueShownAsLabel | Gets or sets a flag that indicates whether to show the value of the data point on the label.(Inherited from DataPointCustomProperties.) |
![]() | IsVisibleInLegend | Gets or sets a flag that indicates whether the item is shown in the legend.(Inherited from DataPointCustomProperties.) |
![]() | Item[Int32] | Gets the DataPointCustomProperties object by its position in the index.(Inherited from DataPointCustomProperties.) |
![]() | Item[String^] | Gets or sets the DataPointCustomProperties object by name.(Inherited from DataPointCustomProperties.) |
![]() | Label | Gets or sets the text of the data point label.(Inherited from DataPointCustomProperties.) |
![]() | LabelAngle | Gets or sets the angle of the data point label.(Inherited from DataPointCustomProperties.) |
![]() | LabelBackColor | Gets or sets the background color of the data point label.(Inherited from DataPointCustomProperties.) |
![]() | LabelBorderColor | Gets or sets the border color of the data point label.(Inherited from DataPointCustomProperties.) |
![]() | LabelBorderDashStyle | Gets or sets the border style of the label.(Inherited from DataPointCustomProperties.) |
![]() | LabelBorderWidth | Gets or sets the border width of the label.(Inherited from DataPointCustomProperties.) |
![]() | LabelForeColor | Gets or sets the text color of the label.(Inherited from DataPointCustomProperties.) |
![]() | LabelFormat | Gets or sets the format of the data point label.(Inherited from DataPointCustomProperties.) |
![]() | LabelToolTip | Gets or sets the tooltip for the data point label.(Inherited from DataPointCustomProperties.) |
![]() | LegendText | Gets or sets the text of the item in the legend.(Inherited from DataPointCustomProperties.) |
![]() | LegendToolTip | Gets or sets the tooltip of the item in the legend.(Inherited from DataPointCustomProperties.) |
![]() | MarkerBorderColor | Gets or sets the border color of the marker.(Inherited from DataPointCustomProperties.) |
![]() | MarkerBorderWidth | Gets or sets the border width of the marker.(Inherited from DataPointCustomProperties.) |
![]() | MarkerColor | Gets or sets the marker color.(Inherited from DataPointCustomProperties.) |
![]() | MarkerImage | Gets or sets the marker image.(Inherited from DataPointCustomProperties.) |
![]() | MarkerImageTransparentColor | Gets or sets the color that will be replaced with a transparent color when the marker image is drawn.(Inherited from DataPointCustomProperties.) |
![]() | MarkerSize | Gets or sets the size of the marker.(Inherited from DataPointCustomProperties.) |
![]() | MarkerStyle | Gets or sets the marker style.(Inherited from DataPointCustomProperties.) |
![]() | Name | Gets or sets the name of the data point.(Overrides ChartNamedElement::Name.) |
![]() | Tag | Gets or sets an object associated with this chart element.(Inherited from ChartElement.) |
![]() | ToolTip | Gets or sets the tooltip.(Inherited from DataPointCustomProperties.) |
![]() | XValue | Gets or sets the X-value of a data point. |
![]() | YValues | Gets or sets the Y-value(s) of a data point. |
| Name | Description | |
|---|---|---|
![]() | Clone() | Returns a new instance that is an exact copy of the data point. |
![]() | DeleteCustomProperty(String^) | Deletes the data point custom property with the specified name.(Inherited from DataPointCustomProperties.) |
![]() | Dispose() | Releases the resources used by the ChartElement.(Inherited from ChartElement.) |
![]() | Dispose(Boolean) | Releases the unmanaged resources used by the ChartElement and optionally releases the managed resources.(Inherited from ChartElement.) |
![]() | Equals(Object^) | Determines whether the specified Object is equal to the current ChartElement.(Inherited from ChartElement.) |
![]() | Finalize() | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.) |
![]() | GetCustomProperty(String^) | Returns the data point custom property with the specified name.(Inherited from DataPointCustomProperties.) |
![]() | GetHashCode() | Returns a hash function for a particular type.(Inherited from ChartElement.) |
![]() | GetType() | |
![]() | GetValueByName(String^) | Returns a data point that is specified by its name. This is a helper function. |
![]() | IsCustomPropertySet(String^) | Determines whether a custom property with the specified name was set.(Inherited from DataPointCustomProperties.) |
![]() | MemberwiseClone() | |
![]() | ResetIsValueShownAsLabel() | Resets a custom property to its default value.(Inherited from DataPointCustomProperties.) |
![]() | ResetIsVisibleInLegend() | Resets a custom property to its default value.(Inherited from DataPointCustomProperties.) |
![]() | SetCustomProperty(String^, String^) | Sets a custom property of the data point.(Inherited from DataPointCustomProperties.) |
![]() | SetDefault(Boolean) | Sets the default properties of the data point. Indicates whether the previous property values must be cleared.(Inherited from DataPointCustomProperties.) |
![]() | SetValueXY(Object^, array<Object^>^) | Sets the X-value and one or more Y-values of the data point. |
![]() | SetValueY(array<Object^>^) | Sets the Y-value(s) of a single data point. |
![]() | ToString() | Returns a string that represents the current Object.(Inherited from ChartElement.) |
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.
Available since 4.0
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.


