UseZValues Property (ShapeSeries)

Specifies whether custom Z positions should be used.

Syntax

Visual Basic
C#

'Declaration
 
<DefaultValueAttribute()>
<DescriptionAttribute("Specifies whether custom Z positions should be used")>
<CategoryAttribute("Options")>
Public Property UseZValues As Boolean

'Usage
 
Dim instance As ShapeSeries
Dim value As Boolean
 
instance.UseZValues = value
 
value = instance.UseZValues

[DefaultValue()]
[Description("Specifies whether custom Z positions should be used")]
[Category("Options")]
public bool UseZValues {get; set;}

Remarks

If this property is set to true the shapes use the coordinates contained in the ZValues data series as their depth coordinate. Note that you must manually switch the scale mode of the depth axis to some of the value scale modes.

Example

The following code displays a XYZ scatter shape.

Visual Basic

Dim shape As ShapeSeries =  Chart.Series.Add(SeriesType.Point) 
shape.UseXValues = True
shape.UseZValues = True
Chart.Axis(StandardAxis.PrimaryX).ScaleMode = AxisScaleMode.Numeric
Chart.Axis(StandardAxis.Depth).ScaleMode = AxisScaleMode.Numeric
shape.AddPoint(12, 23, 4)
shape.AddPoint(25, 34, 13)
...

ShapeSeries shape = Chart.Series.Add(SeriesType.Point);
shape.UseXValues = true;
shape.UseZValues = true;
Chart.Axis(StandardAxis.PrimaryX).ScaleMode = AxisScaleMode.Numeric;
Chart.Axis(StandardAxis.Depth).ScaleMode = AxisScaleMode.Numeric;
shape.AddPoint(12, 23, 4);
shape.AddPoint(25, 34, 13);
...

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ShapeSeries Class
ShapeSeries Members