Shapes.AddShape Method

Adds an AutoShape to a document. Returns a Shape object that represents the AutoShape and adds it to the Shapes collection.

Namespace:  Microsoft.Office.Interop.Word
Assembly:  Microsoft.Office.Interop.Word (in Microsoft.Office.Interop.Word.dll)

Syntax

'Declaration
Function AddShape ( _
    Type As Integer, _
    Left As Single, _
    Top As Single, _
    Width As Single, _
    Height As Single, _
    ByRef Anchor As Object _
) As Shape
'Usage
Dim instance As Shapes
Dim Type As Integer
Dim Left As Single
Dim Top As Single
Dim Width As Single
Dim Height As Single
Dim Anchor As Object
Dim returnValue As Shape

returnValue = instance.AddShape(Type, _
    Left, Top, Width, Height, Anchor)
Shape AddShape(
    int Type,
    float Left,
    float Top,
    float Width,
    float Height,
    ref Object Anchor
)

Parameters

  • Type
    Type: System.Int32
    Required Integer. The type of shape to be returned. Can be any MsoAutoShapeType constant.
  • Left
    Type: System.Single
    Required Single. The position, measured in points, of the left edge of the AutoShape.
  • Top
    Type: System.Single
    Required Single. The position, measured in points, of the top edge of the AutoShape.
  • Width
    Type: System.Single
    Required Single. The width, measured in points, of the AutoShape.
  • Height
    Type: System.Single
    Required Single. The height, measured in points, of the AutoShape.
  • Anchor
    Type: System.Object%
    Optional Object. A Range object that represents the text to which the AutoShape is bound. If Anchor is specified, the anchor is positioned at the beginning of the first paragraph in the anchoring range. If this argument is omitted, the anchoring range is selected automatically and the AutoShape is positioned relative to the top and left edges of the page.

Return Value

Type: Microsoft.Office.Interop.Word.Shape

Remarks

To change the type of an AutoShape that you've added, set the AutoShapeType property.

See Also

Reference

Shapes Interface

Shapes Members

Microsoft.Office.Interop.Word Namespace