ChartArea.GetSeriesZPosition Method (Series)

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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

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

public float GetSeriesZPosition(
	Series series


Type: System.Windows.Forms.DataVisualization.Charting.Series

The Series for which the Z position is retrieved.

Return Value

Type: System.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.

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.


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

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

.NET Framework
Available since 4.0
Return to top