This documentation is archived and is not being maintained.

ChartArea::GetSeriesZPosition Method

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

Namespace:  System.Web.UI.DataVisualization.Charting
Assembly:  System.Web.DataVisualization (in System.Web.DataVisualization.dll)

public:
float GetSeriesZPosition(
	Series^ series
)

Parameters

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

NoteNote

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.

.NET Framework

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: