Shape Properties (Excel)

Contribute to this content Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

Properties

Name	Description
Adjustments	Returns an Adjustments object that contains adjustment values for all the adjustments in the specified shape. Applies to any Shape object that represents an AutoShape, WordArt, or a connector.
AlternativeText	Returns or sets the descriptive (alternative) text string for a Shape object when the object is saved to a Web page. Read/write String.
Application	When used without an object qualifier, this property returns an Application object that represents the Microsoft Excel application. When used with an object qualifier, this property returns an Application object that represents the creator of the specified object (you can use this property with an OLE Automation object to return the application of that object). Read-only.
AutoShapeType	Returns or sets the shape type for the specified Shape or ShapeRange object, which must represent an AutoShape other than a line, freeform drawing, or connector. Read/write MsoAutoShapeType.
BackgroundStyle	Returns or sets the background style. Read/write MsoBackgroundStyleIndex.
BlackWhiteMode	Returns or sets a value that indicates how the specified shape appears when the presentation is viewed in black-and-white mode. Read/write MsoBlackWhiteMode.
BottomRightCell	Returns a Range object that represents the cell that lies under the lower-right corner of the object. Read-only.
Callout	Returns a CalloutFormat object that contains callout formatting properties for the specified shape. Applies to a Shape object that represent line callouts. Read-only.
Chart	Returns a Chart object that represents the chart contained in the shape. Read-only.
Child	Returns msoTrue if the specified shape is a child shape or if all shapes in a shape range are child shapes of the same parent. Read-only MsoTriState.
ConnectionSiteCount	Returns the number of connection sites on the specified shape. Read-only Long.
Connector	True if the specified shape is a connector. Read-only MsoTriState.
ConnectorFormat	Returns a ConnectorFormat object that contains connector formatting properties. Applies to a Shape that represent connectors. Read-only.
ControlFormat	Returns a ControlFormat object that contains Microsoft Excel control properties. Read-only.
Creator	Returns a 32-bit integer that indicates the application in which this object was created. Read-only Long.
Fill	Returns a FillFormat object for a specified shape or a ChartFillFormat object for a specified chart that contains fill formatting properties for the shape or chart. Read-only.
FormControlType	Returns the Microsoft Excel control type. Read-only XlFormControl.
Glow	Returns a GlowFormat object for a specified shape that contains glow formatting properties for the shape. Read-only.
GroupItems	Returns a GroupShapes object that represents the individual shapes in the specified group. Use the Item method of the GroupShapes object to return a single shape from the group. Applies to Shape objects that represent grouped shapes. Read-only.
HasChart	Returns whether a shape contains a chart. Read-only MsoTriState.
HasSmartArt	Returns whether there is a SmartArt diagram present on the specified shape. Read-only
Height	Returns or sets a Single value that represents the height, in points, of the object.
HorizontalFlip	True if the specified shape is flipped around the horizontal axis. Read-only MsoTriState.
Hyperlink	Returns a Hyperlink object that represents the hyperlink for the shape.
ID	Returns a Long value that represents the type for the specified object.
Left	Returns or sets a Single value that represents the distance, in points, from the left edge of the object to the left edge of column A (on a worksheet) or the left edge of the chart area (on a chart).
Line	Returns a LineFormat object that contains line formatting properties for the specified shape. (For a line, the LineFormat object represents the line itself; for a shape with a border, the LineFormat object represents the border). Read-only.
LinkFormat	Returns a LinkFormat object that contains linked OLE object properties. Read-only.
LockAspectRatio	True if the specified shape retains its original proportions when you resize it. False if you can change the height and width of the shape independently of one another when you resize it. Read/write MsoTriState.
Locked	Returns or sets a Boolean value that indicates if the object is locked.
Name	Returns or sets a String value representing the name of the object.
Nodes	Returns a ShapeNodes collection that represents the geometric description of the specified shape.
OLEFormat	Returns an OLEFormat object that contains OLE object properties. Read-only.
OnAction	Returns or sets the name of a macro that’s run when the specified object is clicked. Read/write String.
Parent	Returns the parent object for the specified object. Read-only.
ParentGroup	Returns a Shape object that represents the common parent shape of a child shape or a range of child shapes.
PictureFormat	Returns a PictureFormat object that contains picture formatting properties for the specified shape. Applies to a Shape object that represent pictures or OLE objects. Read-only.
Placement	Returns or sets an XlPlacement value that represents the way the object is attached to the cells below it.
Reflection	Returns a ReflectionFormat object for a specified shape that contains reflection formatting properties for the shape. Read-only.
Rotation	Returns or sets the rotation of the shape, in degrees. Read/write Single.
Shadow	Returns a read-only ShadowFormat object that contains shadow formatting properties for the specified shape or shapes.
ShapeStyle	Returns or sets an MsoShapeStyleIndex that represents the shape style of shape range. Read/write.
SmartArt	Returns an object that represents the SmartArt associated with the shape. Read-only
SoftEdge	Returns a SoftEdgeFormat object for a specified shape that contains soft edge formatting properties for the shape. Read-only.
TextEffect	Returns a TextEffectFormat object that contains text-effect formatting properties for the specified shape. Read-only.
TextFrame	Returns a TextFrame object that contains the alignment and anchoring properties for the specified shape. Read-only.
TextFrame2	Returns a TextFrame2 object that contains text formatting for the specified shape. Read-only.
ThreeD	Returns a ThreeDFormat object that contains 3-D – effect formatting properties for the specified shape. Read-only.
Title	Returns or sets the title of the alternative text associated with the specified shape. Read/write
Top	Returns or sets a Single value that represents the distance, in points, from the top edge of the topmost shape in the shape range to the top edge of the worksheet.
TopLeftCell	Returns a Range object that represents the cell that lies under the upper-left corner of the specified object. Read-only.
Type	Returns or sets a MsoShapeType value that represents the shape type.
VerticalFlip	True if the specified shape is flipped around the vertical axis. Read-only MsoTriState.
Vertices	Returns the coordinates of the specified freeform drawing's vertices (and control points for Bézier curves) as a series of coordinate pairs. You can use the array returned by this property as an argument to the AddCurve method or AddPolyLine method. Read-only Variant.
Visible	Returns or sets a MsoTriState value that determines whether the object is visible. Read/write.
Width	Returns or sets a Single value that represents the width, in points, of the object.
ZOrderPosition	Returns the position of the specified shape in the z-order. Read-only Long.Read-only