Share via


Shape Object Members

Word Developer Reference

Represents an object in the drawing layer, such as an AutoShape, freeform, OLE object, ActiveX control, or picture. The Shape object is a member of the Shapes collection, which includes all the shapes in the main story of a document or in all the headers and footers of a document.

Methods

  Name Description
Bb257743.methods(en-us,office.12).gif Apply Applies to the specified shape formatting that has been copied using the PickUp method.
Bb257743.methods(en-us,office.12).gif CanvasCropBottom Crops a percentage of the height of a drawing canvas from the bottom of the canvas.
Bb257743.methods(en-us,office.12).gif CanvasCropLeft Crops a percentage of the width of a drawing canvas from the left side of the canvas.
Bb257743.methods(en-us,office.12).gif CanvasCropRight Crops a percentage of the width of a drawing canvas from the right side of the canvas.
Bb257743.methods(en-us,office.12).gif CanvasCropTop Crops a percentage of the height of a drawing canvas from the top of the canvas.
Bb257743.methods(en-us,office.12).gif ConvertToFrame Converts the specified shape to a frame. Returns a Frame object that represents the new frame.
Bb257743.methods(en-us,office.12).gif ConvertToInlineShape Converts the specified shape in the drawing layer of a document to an inline shape in the text layer. You can convert only shapes that represent pictures, OLE objects, or ActiveX controls. This method returns an InlineShape object that represents the picture or OLE object.
Bb257743.methods(en-us,office.12).gif Delete Deletes the specified shape node.
Bb257743.methods(en-us,office.12).gif Duplicate Creates a duplicate of the specified Shape object, adds the new shape to the Shapes collection at a standard offset from the original shapes, and then returns the new Shape object.
Bb257743.methods(en-us,office.12).gif Flip Flips a shape horizontally or vertically.
Bb257743.methods(en-us,office.12).gif IncrementLeft Moves the specified shape horizontally by the specified number of points.
Bb257743.methods(en-us,office.12).gif IncrementRotation Changes the rotation of the specified shape around the z-axis by the specified number of degrees.
Bb257743.methods(en-us,office.12).gif IncrementTop Moves the specified shape vertically by the specified number of points.
Bb257743.methods(en-us,office.12).gif PickUp Copies the formatting of the specified shape.
Bb257743.methods(en-us,office.12).gif ScaleHeight Scales the height of the shape by a specified factor.
Bb257743.methods(en-us,office.12).gif ScaleWidth Scales the width of the shape by a specified factor.
Bb257743.methods(en-us,office.12).gif Select Selects the specified shape.
Bb257743.methods(en-us,office.12).gif SetShapesDefaultProperties Applies the formatting of the default shape for a document to the specified shape.
Bb257743.methods(en-us,office.12).gif Ungroup Ungroups any grouped shapes in the specified shape.
Bb257743.methods(en-us,office.12).gif ZOrder Moves the specified shape in front of or behind other shapes in the collection (that is, changes the shape's position in the z-order).

Properties

  Name Description
Bb257743.properties(en-us,office.12).gif Adjustments Returns an Adjustments object that contains adjustment values for all the adjustments in the specified Shape object that represents an AutoShape or WordArt. Read-only.
Bb257743.properties(en-us,office.12).gif AlternativeText Returns or sets the alternative text associated with a shape in a Web page. Read/write String.
Bb257743.properties(en-us,office.12).gif Anchor Returns a Range object that represents the anchoring range for the specified shape or shape range. Read-only.
Bb257743.properties(en-us,office.12).gif Application Returns an Application object that represents the Microsoft Word application.
Bb257743.properties(en-us,office.12).gif AutoShapeType Returns or sets the shape type for the specified Shape object, which must represent an AutoShape other than a line or freeform drawing. Read/write MsoAutoShapeType.
Bb257743.properties(en-us,office.12).gif Callout Returns a CalloutFormat object that contains callout formatting properties for the specified shape. Read-only.
Bb257743.properties(en-us,office.12).gif CanvasItems Returns a CanvasShapes object that represents a collection of shapes in a drawing canvas.
Bb257743.properties(en-us,office.12).gif Child True if the shape is a child shape or if all shapes in a shape range are child shapes of the same parent. Read-only MsoTriState.
Bb257743.properties(en-us,office.12).gif Creator Returns a 32-bit integer that indicates the application in which the specified object was created. Read-only Long.
Bb257743.properties(en-us,office.12).gif Fill Returns a FillFormat object that contains fill formatting properties for the specified shape. Read-only.
Bb257743.properties(en-us,office.12).gif Glow Returns a GlowFormat object that represents the glow formatting for a shape. Read-only.
Bb257743.properties(en-us,office.12).gif GroupItems Returns a GroupShapes object that represents the individual shapes in the specified group. Read-only.
Bb257743.properties(en-us,office.12).gif HasChart True if the specified shape has a chart. Read-only.
Bb257743.properties(en-us,office.12).gif Height Returns or sets the height of the specified shape. Read/write Single.
Bb257743.properties(en-us,office.12).gif HeightRelative Returns or sets a Single that represents the percentage of the relative height of a shape. Read/write.
Bb257743.properties(en-us,office.12).gif HorizontalFlip Indicates that a shape has been flipped horizontally. Read-only MsoTriState.
Bb257743.properties(en-us,office.12).gif Hyperlink Returns a Hyperlink object that represents the hyperlink associated with a Shape object. Read-only.
Bb257743.properties(en-us,office.12).gif ID Returns the identification type for the specified shape. Read-only Long.
Bb257743.properties(en-us,office.12).gif LayoutInCell Returns a Long that represents whether a shape in a table is displayed inside or outside the table.
Bb257743.properties(en-us,office.12).gif Left Returns or sets a Single that represents the horizontal position, measured in points, of the specified shape or shape range. Can also be any valid WdShapePosition constant. Read/write.
Bb257743.properties(en-us,office.12).gif LeftRelative Returns or sets a Single that represents the relative left position of a shape. Read/write.
Bb257743.properties(en-us,office.12).gif Line Returns a LineFormat object that contains line formatting properties for the specified shape. Read-only.
Bb257743.properties(en-us,office.12).gif LinkFormat Returns a LinkFormat object that represents the link options of a shape that is linked to a file. Read/only.
Bb257743.properties(en-us,office.12).gif LockAnchor True if the anchor of a Shape object is locked to the anchoring range. Read/write Long.
Bb257743.properties(en-us,office.12).gif LockAspectRatio MsoTrue if the specified shape retains its original proportions when you resize it. MsoFalse if you can change the height and width of the shape independently of one another when you resize it. Read/write MsoTriState.
Bb257743.properties(en-us,office.12).gif Name Returns or sets the name of the specified object. Read/write String.
Bb257743.properties(en-us,office.12).gif Nodes Returns a ShapeNodes collection that represents the geometric description of the specified shape.
Bb257743.properties(en-us,office.12).gif OLEFormat Returns an OLEFormat object that represents the OLE characteristics (other than linking) for the specified shape, inline shape, or field. Read-only.
Bb257743.properties(en-us,office.12).gif Parent Returns an Object that represents the parent object of the specified Shape object.
Bb257743.properties(en-us,office.12).gif ParentGroup Returns a Shape object that represents the common parent shape of a child shape or a range of child shapes.
Bb257743.properties(en-us,office.12).gif PictureFormat Returns a PictureFormat object that contains picture formatting properties for the specified object. Read-only.
Bb257743.properties(en-us,office.12).gif Reflection Returns a ReflectionFormat object that represents the reflection formatting for a shape. Read-only.
Bb257743.properties(en-us,office.12).gif RelativeHorizontalPosition Specifies to the relative horizontal position of a shape. Read/write WdRelativeHorizontalPosition.
Bb257743.properties(en-us,office.12).gif RelativeHorizontalSize Returns or sets a WdRelativeVerticalSize constant that represents the object to which a range of shapes is relative. Read/write.
Bb257743.properties(en-us,office.12).gif RelativeVerticalPosition Specifies the relative vertical position of a shape. Read/write WdRelativeVerticalPosition.
Bb257743.properties(en-us,office.12).gif RelativeVerticalSize Returns or sets a WdRelativeVerticalSize constant that represents the relative vertical size of a shape. Read/write.
Bb257743.properties(en-us,office.12).gif Rotation Returns or sets the number of degrees the specified shape is rotated around the z-axis. A positive value indicates clockwise rotation; a negative value indicates counterclockwise rotation. Read/write Single.
Bb257743.properties(en-us,office.12).gif Script Returns a Script object, which represents a block of script or code for an image on a Web page.
Bb257743.properties(en-us,office.12).gif Shadow Returns a ShadowFormat object that represents the shadow formatting for the specified shape.
Bb257743.properties(en-us,office.12).gif SoftEdge Returns a SoftEdgeFormat object that represents the soft edge formatting for a shape. Read-only.
Bb257743.properties(en-us,office.12).gif TextEffect Returns a TextEffectFormat object that contains text-effect formatting properties for the specified shape. Read-only.
Bb257743.properties(en-us,office.12).gif TextFrame Returns a TextFrame object that contains the text for the specified shape.
Bb257743.properties(en-us,office.12).gif TextFrame2 Returns a TextFrame2 object that contains the text for the specified shape. Read-only.
Bb257743.properties(en-us,office.12).gif ThreeD Returns a ThreeDFormat object that contains 3-D formatting properties for the specified shape. Read-only.
Bb257743.properties(en-us,office.12).gif Top Returns or sets the vertical position of the specified shape or shape range in points. Read/write Single.
Bb257743.properties(en-us,office.12).gif TopRelative Returns or sets a Single that represents the relative top position of a shape. Read/write.
Bb257743.properties(en-us,office.12).gif Type Returns the type of inline shape. Read-only MsoShapeType.
Bb257743.properties(en-us,office.12).gif VerticalFlip True if the specified shape is flipped around the vertical axis. Read-only MsoTriState.
Bb257743.properties(en-us,office.12).gif Vertices Returns the coordinates of the specified freeform drawing's vertices (and control points for Bézier curves) as a series of coordinate pairs. Read-only Variant.
Bb257743.properties(en-us,office.12).gif Visible True if the specified object, or the formatting applied to it, is visible. Read/write MsoTriState.
Bb257743.properties(en-us,office.12).gif Width Returns or sets the width, in points, of the specified shape. Read/write Long.
Bb257743.properties(en-us,office.12).gif WidthRelative Returns or sets a Single that represents the relative width of a shape. Read/write.
Bb257743.properties(en-us,office.12).gif WrapFormat Returns a WrapFormat object that contains the properties for wrapping text around the specified shape. Read-only.
Bb257743.properties(en-us,office.12).gif ZOrderPosition Returns a Long that represents the position of the specified shape in the z-order. Read-only.