Point3D.Z Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the Z coordinate of a 3D point.
public:
property float Z { float get(); void set(float value); };
[System.ComponentModel.Bindable(true)]
public float Z { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.Z : single with get, set
Public Property Z As Single
Property Value
The Z coordinate of a 3D point, which is measured as a percentage of the relevant chart area's depth.
- Attributes
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 back wall of the chart area and a value of 100 for the front wall of the chart area.
Note This Z property may be less than zero (located behind a chart area) or greater than 100 (located in front of a chart area).
Any point used in custom 3D drawing - which is 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 as its only parameter. By calling the TransformPoints method, the X and Y property values are changed to reflect the 3-dimensional space.
These new X and Y coordinates are then converted to absolute coordinates by using the GetAbsolutePoint method. They are then used for GDI+ method calls.
Relative Z coordinates can be obtained for series by using the GetSeriesDepth and GetSeriesZPosition methods.