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)

Syntax

'Declaration
Sub AddNodes ( _
    SegmentType As MsoSegmentType, _
    EditingType As MsoEditingType, _
    X1 As Single, _
    Y1 As Single, _
    X2 As Single, _
    Y2 As Single, _
    X3 As Single, _
    Y3 As Single _
)
'Usage
Dim instance As FreeformBuilder
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

instance.AddNodes(SegmentType, EditingType, _
    X1, Y1, X2, Y2, X3, Y3)
void AddNodes(
    MsoSegmentType SegmentType,
    MsoEditingType EditingType,
    float X1,
    float Y1,
    float X2,
    float Y2,
    float X3,
    float Y3
)

Parameters

  • SegmentType
    Type: MsoSegmentType
    Required MsoSegmentType. The type of segment to be added.
  • EditingType
    Type: MsoEditingType
    Required MsoEditingType. The editing property of the vertex. If SegmentType is msoSegmentLine, EditingType must be msoEditingAuto.
  • X1
    Type: System.Single
    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
    Type: System.Single
    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
    Type: System.Single
    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
    Type: System.Single
    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
    Type: System.Single
    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
    Type: System.Single
    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.

See Also

Reference

FreeformBuilder Interface

FreeformBuilder Members

Microsoft.Office.Interop.Word Namespace