Points property

Microsoft Visio Developer Reference

Points property

       

Returns an array of points that defines a polyline that approximates a Path or Curve object within a given tolerance.

Version added

5.0

Syntax

object.Points Tolerance, xyArray

object

Required. An expression that returns a Path or Curve object.

Tolerance

Required Double. Specifies how close the returned array of points must approximate the true path.

xyArray

Required Double. Returns an array of alternating x and y values specifying points along a path's or curve's stroke.

Remarks

Use the Points property of the Path or Curve object to obtain an array of x,y coordinates specifying points along the path or curve within a given tolerance. The tolerance and returned x,y values are expressed in internal drawing units (inches).

If you used the Paths property of a Shapes object to obtain the Path or Curve object being queried, the coordinates are expressed in the parent's coordinate system. If you used the PathsLocal property of a Shape object to obtain the Path or Curve object, the coordinates are expressed in the local coordinate system.

If Visio is unable to achieve the requested tolerance, Visio approximates the points as close to the requested tolerance as possible. Generally speaking, the lower the tolerance, the more points Visio returns. Visio doesn't accept a tolerance of zero (0).

The array returned includes both the starting and ending points of the path or curve even if it is closed.