FreeformBuilder.AddNodes Method (Word)
Inserts a new segment at the end of the freeform that's being created, and adds the nodes that define the segment.
Syntax
expression .AddNodes(SegmentType, EditingType, X1, Y1, X2, Y2, X3, Y3)
expression Required. A variable that represents a FreeformBuilder object.
Parameters
Name |
Required/Optional |
Data Type |
Description |
|---|---|---|---|
SegmentType |
Required |
MsoSegmentType |
The type of segment to be added. |
EditingType |
Required |
MsoEditingType |
The editing property of the vertex. If SegmentType is msoSegmentLine, EditingType must be msoEditingAuto. |
X1 |
Required |
Single |
If the EditingType of the new segment is msoEditingAuto, this argument specifies the horizontal distance (in points) from the upper-left corner of the document to the endpoint of the new segment. If the EditingType of the new node is msoEditingCorner, this argument specifies the horizontal distance (in points) from the upper-left corner of the document to the first control point for the new segment. |
Y1 |
Required |
Single |
If the EditingType of the new segment is msoEditingAuto, this argument specifies the vertical distance (in points) from the upper-left corner of the document to the endpoint of the new segment. If the EditingType of the new node is msoEditingCorner, this argument specifies the vertical distance (in points) from the upper-left corner of the document to the first control point for the new segment. |
X2 |
Optional |
Single |
If the EditingType of the new segment is msoEditingCorner, this argument specifies the horizontal distance (in points) from the upper-left corner of the document to the second control point for the new segment. If the EditingType of the new segment is msoEditingAuto, don't specify a value for this argument. |
Y2 |
Optional |
Single |
If the EditingType of the new segment is msoEditingCorner, this argument specifies the vertical distance (in points) from the upper-left corner of the document to the second control point for the new segment. If the EditingType of the new segment is msoEditingAuto, do not specify a value for this argument. |
X3 |
Optional |
Single |
If the EditingType of the new segment is msoEditingCorner, this argument specifies the horizontal distance (in points) from the upper-left corner of the document to the endpoint of the new segment. If the EditingType of the new segment is msoEditingAuto, don't specify a value for this argument. |
Y3 |
Optional |
Single |
If the EditingType of the new segment is msoEditingCorner, this argument specifies the vertical distance (in points) from the upper-left corner of the document to the endpoint of the new segment. If the EditingType of the new segment is msoEditingAuto, don't specify a value for this argument. |
Remarks
You can use this method as many times as you want to add nodes to the freeform you are creating. When you finish adding nodes, use the ConvertToShape method to create the freeform you've just defined. To add nodes to a freeform after it has been created, use the Insert method of the ShapeNodes collection.
Example
This example adds a freeform with five vertices to the active document.
Dim docActive As Document
Set docActive = ActiveDocument
With docActive.Shapes.BuildFreeform(msoEditingCorner, 360, 200)
.AddNodes msoSegmentCurve, msoEditingCorner, _
380, 230, 400, 250, 450, 300
.AddNodes msoSegmentCurve, msoEditingAuto, 480, 200
.AddNodes msoSegmentLine, msoEditingAuto, 480, 400
.AddNodes msoSegmentLine, msoEditingAuto, 360, 200
.ConvertToShape
End With