Dundas Chart for Windows Forms
Z Property
See Also  Send comments on this topic.
DundasWinChart Assembly > Dundas.Charting.WinControl Namespace > Point3D Class : Z Property


Gets or sets the Z coordinate of a 3D point.


Z coordinate of the point.

Syntax

Visual Basic (Declaration)  
Public Property Z As Single
Visual Basic (Usage) Copy Code
Dim instance As Point3D
Dim value As Single
 
instance.Z = value
 
value = instance.Z
C#  
public float Z {get; set;}

Return Value

The Z coordinate of a 3D point (measured as a percentage of the relevant chart area's depth).

Remarks

This Z property is always expressed as a percentage of the relevant chart area's depth (with 3D charts Z coordinates are relative, and have a value of 0 for the backwall of the chart area and a value of 100 for the front wall of the chart area).

Note that this Z property may be less than zero (behind a chart area) or greater than 100 (in front of a chart area).

Any point used in custom 3D drawing (accomplished using GDI+) must be transformed from X, Y and Z (3D) coordinates into X and Y (2D) coordinates using the TransformPoints method. This method takes an array of Point3D objects for its one parameter, and by calling TransformPoints the X and Y property values are changed to reflect the 3-dimensional space.

These new X and Y coordinates are then changed to absolute coordinates (e.g. using the GetAbsolutePoint method of a ChartGraphics object) and then used for GDI+ method calls. For more information see the "Custom Drawing Section" in the Working with 3D Charts topic.

Relative Z coordinates can be obtained for series using the GetSeriesDepth and GetSeriesZPosition methods of the ChartArea class.

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.