Share via

Shape Members

  • Article

Include Protected Members
Include Inherited Members

Represents an object in the drawing layer, such as an AutoShape, freeform, OLE object, ActiveX control, or picture.

The Shape type exposes the following members.

Methods

  Name Description
Public method Activate Activates the specified object.
Public method Apply Applies to the specified shape formatting that has been copied using the PickUp method.
Public method CanvasCropBottom Crops a percentage of the height of a drawing canvas from the bottom of the canvas.
Public method CanvasCropLeft Crops a percentage of the width of a drawing canvas from the left side of the canvas.
Public method CanvasCropRight Crops a percentage of the width of a drawing canvas from the right side of the canvas.
Public method CanvasCropTop Crops a percentage of the height of a drawing canvas from the top of the canvas.
Public method ConvertToFrame Converts the specified shape to a frame.
Public method ConvertToInlineShape Converts the specified shape in the drawing layer of a document to an inline shape in the text layer.
Public method Delete Deletes the specified object.
Public method Duplicate Creates a duplicate of the specified Shape object, adds the new range of shapes to the Shapes collection at a standard offset from the original shapes, and then returns the new Shape object.
Public method Flip Flips a shape horizontally or vertically.
Public method IncrementLeft Moves the specified shape horizontally by the specified number of points.
Public method IncrementRotation Changes the rotation of the specified shape around the z-axis by the specified number of degrees.
Public method IncrementTop Moves the specified shape vertically by the specified number of points.
Public method PickUp Copies the formatting of the specified shape.
Public method RerouteConnections Reserved for internal use.
Public method ScaleHeight Scales the height of the shape by a specified factor.
Public method ScaleWidth Scales the width of the shape by a specified factor.
Public method Select Selects the specified object.
Public method SetShapesDefaultProperties Applies the formatting of the specified shape to a default shape for that document. New shapes inherit many of their attributes from the default shape.
Public method Ungroup Ungroups any grouped shapes in the specified shape.
Public method 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).

Top

Properties

  Name Description
Public property Adjustments Returns a Adjustments object that contains adjustment values for all the adjustments in the specified Shape object that represents an AutoShape or WordArt.
Public property AlternativeText Returns or sets the alternative text associated with a shape in a Web page.
Public property Anchor Returns a Range object that represents the anchoring range for the specified shape.
Public property Application Returns a Application object that represents the Microsoft Word application.
Public property AutoShapeType Returns or sets the shape type for the specified Shape object, which must represent an AutoShape other than a line or freeform drawing.
Public property BackgroundStyle Gets or sets the background style of the specified shape.
Public property Callout Returns a CalloutFormat object that contains callout formatting properties for the specified shape.
Public property CanvasItems Returns a CanvasShapes object that represents a collection of shapes in a drawing canvas.
Public property Chart Returns a Chart object that represents a chart within the collection of shapes in a document. Read-only.
Public property Child Determines if the shape is a child shape.
Public property ConnectionSiteCount Reserved for internal use.
Public property Connector Reserved for internal use.
Public property ConnectorFormat Reserved for internal use.
Public property Creator Returns a 32-bit integer that indicates the application in which the specified object was created.
Public property Diagram Returns a Diagram object to which a diagram node belongs.
Public property DiagramNode Returns a DiagramNode object that represents a node in a diagram.
Public property Fill Returns a FillFormat object that contains fill formatting properties for the specified shape.
Public property Glow Returns a GlowFormat object that represents the glow formatting for a shape. Read-only.
Public property GroupItems Returns a GroupShapes object that represents the individual shapes in the specified group.
Public property HasChart True if the specified shape has a chart. Read-only.
Public property HasDiagram Determines if a shape is a diagram.
Public property HasDiagramNode Determines if a shape is a diagram node.
Public property HasSmartArt Gets True if there is a SmartArt diagram present on the shape.
Public property Height Returns or sets the height of the specified shape in points.
Public property HeightRelative Returns or sets a Single that represents the percentage of the relative height of a shape. Read/write.
Public property HorizontalFlip Indicates that a shape has been flipped horizontally.
Public property Hyperlink Returns a Hyperlink object that represents the hyperlink associated with the specified shape.
Public property ID Returns the type for the specified object.
Public property LayoutInCell Returns an Integer that represents whether a shape in a table is displayed inside the table or outside of the table.
Public property Left Returns or sets a Single that represents the horizontal position, measured in points, of the specified shape or shape range.
Public property LeftRelative Returns or sets a Single that represents the relative left position of a shape. Read/write.
Public property Line Returns a LineFormat object that contains line formatting properties for the specified shape.
Public property LinkFormat Returns a LinkFormat object that represents the link options of the specified shape that's linked to a file.
Public property LockAnchor Determines if the specified Shape object's anchor is locked to the anchoring range.
Public property LockAspectRatio Determines if you can change the height and width of the shape independently of one another when you resize it or if it retains its original proportions.
Public property Name Returns or sets the name of the specified object.
Public property Nodes Returns a ShapeNodes collection that represents the geometric description of the specified shape.
Public property OLEFormat Returns a OLEFormat object that represents the OLE characteristics (other than linking) for the specified shape.
Public property Parent Returns an object that represents the parent object of the specified object.
Public property ParentGroup Returns a Shape object that represents the common parent shape of a child shape.
Public property PictureFormat Returns a PictureFormat object that contains picture formatting properties for the specified object.
Public property Reflection Returns a ReflectionFormat object that represents the reflection formatting for a shape. Read-only.
Public property RelativeHorizontalPosition Specifies to what the horizontal position of a shape is relative.
Public property RelativeHorizontalSize Returns or sets a WdRelativeHorizontalSize constant that represents the object to which a range of shapes is relative. Read/write.
Public property RelativeVerticalPosition Specifies to what the vertical position of a shape is relative.
Public property RelativeVerticalSize Returns or sets a WdRelativeVerticalSize constant that represents the relative vertical size of a shape. Read/write.
Public property Rotation Returns or sets the number of degrees the specified shape is rotated around the z-axis.
Public property RTF Reserved for internal use.
Public property Script Returns a Script object, which represents a block of script or code on the specified Web page.
Public property Shadow Returns a ShadowFormat object that represents the shadow formatting for the specified shape.
Public property ShapeStyle Gets or sets the shape style for the specified shape.
Public property SmartArt Gets a SmartArt object that provides a way to work with the SmartArt associated with the specified shape.
Public property SoftEdge Returns a SoftEdgeFormat object that represents the soft edge formatting for a shape. Read-only.
Public property TextEffect Returns a TextEffectFormat object that contains text-effect formatting properties for the specified shape.
Public property TextFrame Returns a TextFrame object that contains the text for the specified shape.
Public property TextFrame2 Returns a TextFrame2 object that contains the text for the specified shape. Read-only.
Public property ThreeD Returns a ThreeDFormat object that contains formatting properties of the three-dimensional effect for the specified shape.
Public property Title Gets or sets a string that contains a title for the specified shape.
Public property Top Returns or sets the vertical position of the specified shape in points.
Public property TopRelative Returns or sets a Single that represents the relative top position of a shape. Read/write.
Public property Type Returns the shape type.
Public property VerticalFlip Determines if the specified shape is flipped around the vertical axis.
Public property Vertices Returns the coordinates of the specified freeform drawing's vertices (and control points for Bézier curves) as a series of coordinate pairs.
Public property Visible Determines if the specified object, or the formatting applied to it, is visible.
Public property Width Returns or sets the width of the specified object, in points.
Public property WidthRelative Returns or sets a Single that represents the relative width of a shape. Read/write.
Public property WrapFormat Returns a WrapFormat object that contains the properties for wrapping text around the specified shape.
Public property ZOrderPosition Returns the position of the specified shape in the z-order.

Top

See Also

Reference

Shape Interface

Microsoft.Office.Interop.Word Namespace