Share via

AddPolyline Method

  • Article

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.

Adds a new Shape object representing an open polyline or a closed polygon to the specified Shapes collection.

expression.AddPolyline(SafeArrayOfPoints)

expression   Required. An expression that returns one of the objects in the Applies To list.

SafeArrayOfPoints  Required Variant. An array of coordinate pairs that specifies the polyline's or polygon's vertices.

Remarks

For the array elements in SafeArrayOfPoints, numeric values are evaluated in points; strings can be in any units supported by Microsoft Publisher (for example, "2.5 in").

To form a closed polygon, assign the same coordinates to the first and last vertices in the polyline drawing.

Example

The following example adds a triangle to the first page of the active publication. Because the first and last points have the same coordinates, the polygon is closed.

  Dim shpPolyline As Shape
Dim arrPoints(1 To 4, 1 To 2) As Single

arrPoints(1, 1) = 25
arrPoints(1, 2) = 100
arrPoints(2, 1) = 100
arrPoints(2, 2) = 150
arrPoints(3, 1) = 150
arrPoints(3, 2) = 50
arrPoints(4, 1) = 25
arrPoints(4, 2) = 100

Set shpPolyline = ActiveDocument.Pages(1).Shapes.AddPolyline _
    (SafeArrayOfPoints:=arrPoints)