Gets or sets the Z coordinate of a 3D point.
Z coordinate of the point.
Visual Basic (Declaration) | |
---|---|
Public Property Z As Single |
Visual Basic (Usage) | Copy Code |
---|---|
|
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).
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.
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