DataPoint Class

.NET Framework (current version)
 

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

Namespace:   System.Windows.Forms.DataVisualization.Charting
Assembly:  System.Windows.Forms.DataVisualization (in System.Windows.Forms.DataVisualization.dll)


[TypeConverterAttribute("System.Windows.Forms.Design.DataVisualization.Charting.DataPointConverter, System.Windows.Forms.DataVisualization.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35")]
public class DataPoint : DataPointCustomProperties

NameDescription
System_CAPS_pubmethodDataPoint()

Initializes a new instance of the DataPoint class.

System_CAPS_pubmethodDataPoint(Double, Double)

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

System_CAPS_pubmethodDataPoint(Double, Double[])

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

System_CAPS_pubmethodDataPoint(Double, String)

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

System_CAPS_pubmethodDataPoint(Series)

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

NameDescription
System_CAPS_pubpropertyAxisLabel

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.)

System_CAPS_pubpropertyBackGradientStyle

Gets or sets the background gradient style.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyBackHatchStyle

Gets or sets the background hatching style.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyBackImage

Gets or sets the background image of the data point.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyBackImageAlignment

Gets or sets the alignment of the background image, which is used with the Unscaled drawing mode.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyBackImageTransparentColor

Gets or sets a color that will be replaced with a transparent color when the background image is drawn.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyBackImageWrapMode

Gets or sets the drawing mode of the background image.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyBackSecondaryColor

Gets or sets the secondary background color.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyBorderColor

Gets or sets the border color of the data point.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyBorderDashStyle

Gets or sets the border style of the data point.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyBorderWidth

Gets or sets the border width of the data point.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyColor

Gets or sets the color of the data point.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyCustomProperties

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.)

System_CAPS_pubpropertyCustomPropertiesExtended

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.)

System_CAPS_pubpropertyFont

Gets or sets the font of the data point.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyIsEmpty

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

System_CAPS_pubpropertyIsValueShownAsLabel

Gets or sets a flag that indicates whether to show the value of the data point on the label.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyIsVisibleInLegend

Gets or sets a flag that indicates whether the item is shown in the legend.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyItem[Int32]

Gets the DataPointCustomProperties object by its position in the index.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyItem[String]

Gets or sets the DataPointCustomProperties object by name.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyLabel

Gets or sets the text of the data point label.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyLabelAngle

Gets or sets the angle of the data point label.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyLabelBackColor

Gets or sets the background color of the data point label.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyLabelBorderColor

Gets or sets the border color of the data point label.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyLabelBorderDashStyle

Gets or sets the border style of the label.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyLabelBorderWidth

Gets or sets the border width of the label.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyLabelForeColor

Gets or sets the text color of the label.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyLabelFormat

Gets or sets the format of the data point label.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyLabelToolTip

Gets or sets the tooltip for the data point label.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyLegendText

Gets or sets the text of the item in the legend.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyLegendToolTip

Gets or sets the tooltip of the item in the legend.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyMarkerBorderColor

Gets or sets the border color of the marker.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyMarkerBorderWidth

Gets or sets the border width of the marker.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyMarkerColor

Gets or sets the marker color.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyMarkerImage

Gets or sets the marker image.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyMarkerImageTransparentColor

Gets or sets the color that will be replaced with a transparent color when the marker image is drawn.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyMarkerSize

Gets or sets the size of the marker.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyMarkerStyle

Gets or sets the marker style.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyName

Gets or sets the name of the data point.(Overrides ChartNamedElement.Name.)

System_CAPS_pubpropertyTag

Gets or sets an object associated with this chart element.(Inherited from ChartElement.)

System_CAPS_pubpropertyToolTip

Gets or sets the tooltip.(Inherited from DataPointCustomProperties.)

System_CAPS_pubpropertyXValue

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

System_CAPS_pubpropertyYValues

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

NameDescription
System_CAPS_pubmethodClone()

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

System_CAPS_pubmethodDeleteCustomProperty(String)

Deletes the data point custom property with the specified name.(Inherited from DataPointCustomProperties.)

System_CAPS_pubmethodDispose()

Releases the resources used by the ChartElement.(Inherited from ChartElement.)

System_CAPS_protmethodDispose(Boolean)

Releases the unmanaged resources used by the ChartElement and optionally releases the managed resources.(Inherited from ChartElement.)

System_CAPS_pubmethodEquals(Object)

Determines whether the specified Object is equal to the current ChartElement.(Inherited from ChartElement.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetCustomProperty(String)

Returns the data point custom property with the specified name.(Inherited from DataPointCustomProperties.)

System_CAPS_pubmethodGetHashCode()

Returns a hash function for a particular type.(Inherited from ChartElement.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodGetValueByName(String)

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

System_CAPS_pubmethodIsCustomPropertySet(String)

Determines whether a custom property with the specified name was set.(Inherited from DataPointCustomProperties.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodResetIsValueShownAsLabel()

Resets a custom property to its default value.(Inherited from DataPointCustomProperties.)

System_CAPS_pubmethodResetIsVisibleInLegend()

Resets a custom property to its default value.(Inherited from DataPointCustomProperties.)

System_CAPS_pubmethodSetCustomProperty(String, String)

Sets a custom property of the data point.(Inherited from DataPointCustomProperties.)

System_CAPS_pubmethodSetDefault(Boolean)

Sets the default properties of the data point. Indicates whether the previous property values must be cleared.(Inherited from DataPointCustomProperties.)

System_CAPS_pubmethodSetValueXY(Object, Object[])

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

System_CAPS_pubmethodSetValueY(Object[])

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

System_CAPS_pubmethodToString()

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.

.NET Framework
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.

Return to top
Show: