UseZValues Property (LineSeries)

Specifies whether custom Z positions should be used.

Syntax

Visual Basic
C#

'Declaration
 
<DefaultValueAttribute()>

<CategoryAttribute("Options")>

<DescriptionAttribute("Specifies whether custom Z positions should be used.")>

Public Property UseZValues As Boolean

'Usage
 
Dim instance As LineSeries

Dim value As Boolean

 

instance.UseZValues = value

 

value = instance.UseZValues

[DefaultValue()]

[Category("Options")]

[Description("Specifies whether custom Z positions should be used.")]

public bool UseZValues {get; set;}

Remarks

If this property is set to true the line end-points 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 point.

Visual Basic

Dim line As LineSeries =  Chart.Series.Add(SeriesType.Line)

line.UseXValues = True

line.UseZValues = True

Chart.Axis(StandardAxis.PrimaryX).ScaleMode = AxisScaleMode.Numeric

Chart.Axis(StandardAxis.Depth).ScaleMode = AxisScaleMode.Numeric

line.AddXYZ(12, 23, 4)

line.AddXYZ(25, 34, 13)

...

LineSeries line = (LineSeries)chart.Series.Add(SeriesType.Line);

line.UseXValues = true;

line.UseZValues = true;

Chart.Axis(StandardAxis.PrimaryX).ScaleMode = AxisScaleMode.Numeric;

Chart.Axis(StandardAxis.Depth).ScaleMode = AxisScaleMode.Numeric;

line.AddXYZ(12, 23, 4);

line.AddXYZ(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

LineSeries Class
LineSeries Members