location_object.XYZInc Method

Increments the X/Y/Z components of the PosWrtRef value of a Cartesian Location Object by specified amounts.

location_object.XYZInc(x,y,z)

Prerequisites

The location_object must be a Cartesian Location Object.

Parameters

x

An optional numeric expression that specifies the amount by which the X value is incremented. If this value is not specified, a default value of 0 is assumed.

y

An optional numeric expression that specifies the amount by which the Y value is incremented. If this value is not specified, a default value of 0 is assumed.

z

An optional numeric expression that specifies the amount by which the Z value is incremented. If this value is not specified, a default value of 0 is assumed.

Remarks

This method increments the X, Y, and Z Cartesian displacement components of the location_object’s PosWrtRef value in a single operation.  Any unspecified increments leave the corresponding displacement values unchanged.

Examples

Dim loc1 As New Location      ' Create new Location set to default values
loc1.XYZ(10,20,30,0,180,25) ' Set PosWrtRef value of loc1
loc1.XYZInc(-3,,2) ' Changes X to 7 and Z to 32

See Also

Location Class | location_object.X|location_object.Y|location_object.Z|location_object.Yaw | Location.XYZValue