ChartArea::GetSeriesDepth Method (Series^)

.NET Framework (current version)
 

Returns the depth of a Series in a chart area.

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

public:
float GetSeriesDepth(
	Series^ series
)

Parameters

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

The Series for which the depth is retrieved.

Return Value

Type: System::Single

A float value that represents the depth of the specified Series, which is measured as a percentage of the chart area's depth.

Call this method to get the depth of a specified series. The returned value is measured as a percentage of the chart area's depth, which is the same unit of measurement used in the Z property.

All series have a depth, regardless of their chart type. For example, even point and bubble series have a depth, even though the entire depth is not used to draw the points or bubbles.

The depth of a series can be used to determine a Z value for a point that is used in a custom drawing routine.

System_CAPS_noteNote

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
Show: