Table of contents
TOC
Collapse the table of content
Expand the table of content

ShapeNodes.Insert Method (Publisher)

office 365 dev account|Last Updated: 8/24/2017
|
3 Contributors

Inserts a new segment after the specified node of the freeform drawing.

Syntax

expression. Insert( Index, SegmentType, EditingType, X1, Y1, X2, Y2, X3, Y3)

_expression_A variable that represents a ShapeNodes object.

Parameters

NameRequired/OptionalData TypeDescription
IndexRequiredLongThe number of the node after which the new node is to be inserted.
SegmentTypeRequiredMsoSegmentTypeThe type of segment to be added.
EditingTypeRequiredMsoEditingTypeSpecifies the editing type of the new node.
X1RequiredVariantIf the EditingType of the new segment is msoEditingAuto, this argument specifies the horizontal distance from the upper-left corner of the page to the endpoint of the new segment. If the EditingType of the new node is msoEditingCorner, this argument specifies the horizontal distance from the upper-left corner of the page to the first control point for the new segment.
Y1RequiredVariantIf the EditingType of the new segment is msoEditingAuto, this argument specifies the vertical distance from the upper-left corner of the page to the endpoint of the new segment. If the EditingType of the new node is msoEditingCorner, this argument specifies the vertical distance from the upper-left corner of the page to the first control point for the new segment.
X2OptionalVariantIf the EditingType of the new segment is msoEditingCorner, this argument specifies the horizontal distance from the upper-left corner of the page 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.
Y2OptionalVariantIf the EditingType of the new segment is msoEditingCorner, this argument specifies the vertical distance from the upper-left corner of the page 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.
X3OptionalVariantIf the EditingType of the new segment is msoEditingCorner, this argument specifies the horizontal distance from the upper-left corner of the page to the endpoint of the new segment. If the EditingType of the new segment is msoEditingAuto, do not specify a value for this argument.
Y3OptionalVariantIf the EditingType of the new segment is msoEditingCorner, this argument specifies the vertical distance from the upper-left corner of the page to the endpoint of the new segment. If the EditingType of the new segment is msoEditingAuto, do not specify a value for this argument.

Remarks

For the X1, Y1, X2, Y2, X3, and Y3 arguments, numeric values are evaluated in points; strings can be in any units supported by Publisher (for example, "2.5 in").

SegmentType can be one of these MsoSegmentType constants.

| msoSegmentCurve| | msoSegmentLine| EditingType can be one of these MsoEditingType constants.

| msoEditingAuto|Adds a node type appropriate to the segments being connected.| | msoEditingCorner|Adds a corner node.|

Example

This example adds a smooth node with a curved segment after node four in the third shape in the active publication. The shape must be a freeform drawing with at least four nodes.

With ActiveDocument.Pages(1).Shapes(3).Nodes 
 .Insert Index:=4, _ 
 SegmentType:=msoSegmentCurve, _ 
 EditingType:=msoEditingAuto, _ 
 X1:=210, Y1:=100 
End With 
© 2018 Microsoft