Dundas Chart for Windows Forms
GetSeriesDepth Method
See Also  Send comments on this topic.
DundasWinChart Assembly > Dundas.Charting.WinControl Namespace > ChartArea Class : GetSeriesDepth Method


series
The series to retrieve the depth for.

Call this method to get the depth of a series in a chart area.

Syntax

Visual Basic (Declaration)  
Public Function GetSeriesDepth( _
   ByVal series As Series _
) As Single
Visual Basic (Usage) Copy Code
Dim instance As ChartArea
Dim series As Series
Dim value As Single
 
value = instance.GetSeriesDepth(series)
C#  
public float GetSeriesDepth( 
   Series series
)

Parameters

series
The series to retrieve the depth for.

Return Value

The depth of the specified series. Measured as a percentage of the chart area's depth.

Remarks

Call this method to get the depth of a specified series (see Figure 1 below). The returned value is measured as a percentage of the chart area's depth (the same unit of measurement as the Point3D.Z property).

      Figure 1: Series depth and Z position

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 some custom drawing routine.

Note that any points used in custom 3D drawing must first be transformed from relative X, Y and Z (3D) coordinates into relative X and Y (2D) coordinates using the TransformPoints method. For more information see the "Custom Drawing Section" in the Working with 3D Charts topic.

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

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2009 All Rights Reserved.