Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Point3D.Z Property

.NET Framework 4.6 and 4.5

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

Namespace:  System.Web.UI.DataVisualization.Charting
Assembly:  System.Web.DataVisualization (in System.Web.DataVisualization.dll)

public float Z { get; set; }

Property Value

Type: System.Single
The Z coordinate of a 3D point, which is 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 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.

.NET Framework

Supported in: 4.6, 4.5, 4
© 2015 Microsoft