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


series
The series to retrieve the Z position for.

Call this method to get the Z position of a series (useful for custom drawing).

Syntax

Visual Basic (Declaration)  
Public Function GetSeriesZPosition( _
   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.GetSeriesZPosition(series)
C#  
public float GetSeriesZPosition( 
   Series series
)

Parameters

series
The series to retrieve the Z position for.

Return Value

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

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. See figure 1 below for an illustration of the Z position.

      Figure 1: Series depth and Z position

The Z position of a series is normally used for some custom drawing routine.

Note that any points used in custom 3D drawing must be transformed from relative 3D coordinates into relative 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.