Share via

Shapes.AddShape Method

  • Article
Publisher Developer Reference

Adds a new Shape object representing an AutoShape to the specified Shapes collection.

Syntax

expression.AddShape(Type, Left, Top, Width, Height)

expression   A variable that represents a Shapes object.

Parameters

Name Required/Optional Data Type Description
Type Required MsoAutoShapeType The type of AutoShape to draw. For a complete list of MsoAutoShapeType constants, see the Object Browser.
Left Required Variant The position of the left edge of the shape representing the AutoShape.
Top Required Variant The position of the top edge of the shape representing the AutoShape.
Width Required Variant The width of the shape representing the AutoShape.
Height Required Variant The height of the shape representing the AutoShape.

Return Value
Shape

Remarks

For the Left, Top, Width, and Height arguments, numeric values are evaluated in points; strings can be in any units supported by Microsoft Office Publisher (for example, "2.5 in").

Example

The following example adds a rectangle to the first page of the active publication.

Visual Basic for Applications 
  Dim shpShape As Shape

Set shpShape = ActiveDocument.Pages(1).Shapes.AddShape _
(Type:=msoShapeRectangle, _
Left:=144, Top:=144, _
Width:=72, Height:=144)

See Also