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