ChartArea.GetSeriesZPosition(Series) Method

Reference

Definition

Namespace:: System.Windows.Forms.DataVisualization.Charting

Assembly:: System.Windows.Forms.DataVisualization.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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.

Applies to

Jaa