FreeformBuilder.AddNodes Method 

Inserts a new segment at the end of the freeform that's being created, and adds the nodes that define the segment.

Namespace: Microsoft.Office.Interop.Word
Assembly: Microsoft.Office.Interop.Word (in microsoft.office.interop.word.dll)

Usage

Dim SegmentType As MsoSegmentType
Dim EditingType As MsoEditingType
Dim X1 As Single
Dim Y1 As Single
Dim X2 As Single
Dim Y2 As Single
Dim X3 As Single
Dim Y3 As Single
Dim freeformBuilder1 As FreeformBuilder
freeformBuilder1.AddNodes(SegmentType, EditingType, X1, Y1, X2, Y2, X3, Y3)

Syntax

Sub AddNodes( _
    <InAttribute()> ByVal SegmentType As MsoSegmentType, _
    <InAttribute()> ByVal EditingType As MsoEditingType, _
    <InAttribute()> ByVal X1 As Single, _
    <InAttribute()> ByVal Y1 As Single, _
    <InAttribute()> Optional ByVal X2 As Single, _
    <InAttribute()> Optional ByVal Y2 As Single, _
    <InAttribute()> Optional ByVal X3 As Single, _
    <InAttribute()> Optional ByVal Y3 As Single _
)

void AddNodes(
    [In] MsoSegmentType SegmentType, 
    [In] MsoEditingType EditingType, 
    [In] float X1, 
    [In] float Y1, 
    [In, Optional] float X2, 
    [In, Optional] float Y2, 
    [In, Optional] float X3, 
    [In, Optional] float Y3
);

public: Void AddNodes(
    MsoSegmentType^ SegmentType, 
    MsoEditingType^ EditingType, 
    Single X1, 
    Single Y1, 
    Single X2, 
    Single Y2, 
    Single X3, 
    Single Y3
);

public void AddNodes(
    /*in*/MsoSegmentType SegmentType, 
    /*in*/MsoEditingType EditingType, 
    /*in*/float X1, 
    /*in*/float Y1, 
    /*in*/float X2, 
    /*in*/float Y2, 
    /*in*/float X3, 
    /*in*/float Y3
);

function AddNodes(
     SegmentType : MsoSegmentType, 
     EditingType : MsoEditingType, 
     X1 : float, 
     Y1 : float, 
     X2 : float, 
     Y2 : float, 
     X3 : float, 
     Y3 : float
);

Parameters

• SegmentType
  Required Microsoft.Office.Core.MsoSegmentType. The type of segment to be added.

• EditingType
  Required Microsoft.Office.Core.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 end point 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 end point 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, don't 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 end point 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 end point 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're 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's been created, use the Insert method of the ShapeNodes collection.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, and Windows 2000

Target Platforms

See Also

Reference

FreeformBuilder Interface
Microsoft.Office.Interop.Word Namespace

Other Resources

FreeformBuilder Members