ChartArea.GetSeriesZPosition(Series) Method

Definition

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Returns the Z position of a series, which is useful for custom drawing.

public:
 float GetSeriesZPosition(System::Windows::Forms::DataVisualization::Charting::Series ^ series);

public float GetSeriesZPosition (System.Windows.Forms.DataVisualization.Charting.Series series);

member this.GetSeriesZPosition : System.Windows.Forms.DataVisualization.Charting.Series -> single

Public Function GetSeriesZPosition (series As Series) As Single

Parameters

series

Series

The Series for which the Z position is retrieved.

Returns

Single

A float value that represents the Z position of the specified series, which is measured as a percentage of the depth of a chart area.

Remarks

Call this method to get the Z position of a series. The Z position is measured from the back wall of the chart area to the center of a data series, and is represented as a percentage of the chart area's depth. For example, a series that is drawn halfway along the Z-axis has a Z position of 50.

The Z position of a series is normally used for a custom drawing routine.

Note

Any points used in custom 3D drawing must be transformed from relative 3D coordinates to relative 2D coordinates using the TransformPoints method.

To get relative X and Y-values from an axis, use the ValueToPosition method for both the X and Y axes.