Points property
Points property
This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.
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 |
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.