Shape Members

Include Protected Members
Include Inherited Members

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

The Shape type exposes the following members.

Properties

	Name	Description
	ActionSettings	Returns an ActionSettings object that contains information about what action occurs when the user clicks or moves the mouse over the specified shape or text range during a slide show. Read-only.
	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. Read-only.
	AlternativeText	Returns or sets the alternative text associated with a shape in a Web presentation. Read/write.
	AnimationSettings	Returns an AnimationSettings object that represents all the special effects that you can apply to the animation of the specified shape. Read-only.
	Application	Returns an Application object that represents the creator of the specified object.
	AutoShapeType	Returns or sets the shape type for the specified Shape object, which must represent an AutoShape other than a line, freeform drawing, or connector. Read/write.
	BackgroundStyle	Sets or returns the background style of the specified object. Read/write.
	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.
	Callout	Returns a CalloutFormat object that contains callout formatting properties for the specified shape. Applies to Shape or ShapeRange objects that represent line callouts. Read-only.
	CanvasItems	Reserved for internal use.
	Chart	Returns a Chart object of the current Shape object. Read-only.
	Child	msoTrue if the shape is a child shape or if all shapes in a shape range are child shapes of the same parent. Read-only.
	ConnectionSiteCount	Returns the number of connection sites on the specified shape. Read-only.
	Connector	Determines whether the specified shape is a connector. Read-only.
	ConnectorFormat	Returns a ConnectorFormat object that contains connector formatting properties. Applies to Shape or ShapeRange objects that represent connectors. Read-only.
	Creator	Returns a 64-bit signed integer that represents the four-character creator code for the application in which the specified object was created. For example, if the object was created in Microsoft PowerPoint, this property returns the hexadecimal number 50575054. Read-only.
	CustomerData	Returns a CustomerData object. Read-only.
	Diagram	Reserved for internal use.
	DiagramNode	Reserved for internal use.
	Fill	Returns a FillFormat object that contains fill formatting properties for the specified shape. Read-only.
	Glow	Returns the glow format for the specified shape. Read-only.
	GroupItems	Returns a GroupShapes object that represents the individual shapes in the specified group. Use the Item[Object] method of the GroupShapes object to return a single shape from the group. Read-only.
	HasChart	Returns whether the shape represented by the specified object contains a chart. Read-only.
	HasDiagram	Reserved for internal use.
	HasDiagramNode	Reserved for internal use.
	HasSmartArt	Returns true if the current Shape object contains a SmartArt diagram. Read-only.
	HasTable	Returns whether the specified shape is a table. Read-only.
	HasTextFrame	Returns whether the specified shape has a text frame. Read-only.
	Height	Returns or sets the height of the specified object, in points. Read/write.
	HorizontalFlip	Returns whether the specified shape is flipped around the horizontal axis. Read-only.
	Id	Returns a 64-bit signed integer that identifies the shape or range of shapes. Read-only.
	Left	Returns or sets a single-precision floating-point number that represents the distance in points from the left edge of the shape's bounding box to the left edge of the slide. Read/write.
	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 the properties that are unique to linked OLE objects. Read-only.
	LockAspectRatio	Determines whether the specified shape retains its original proportions when you resize it. Read/write.
	MediaFormat	Allows access to the new audio or video object. Read-only.
	MediaType	Returns the OLE media type. Read-only.
	Name	When a shape is created, Microsoft PowerPoint automatically assigns it a name in the form ShapeType Number, where ShapeType identifies the type of shape or AutoShape, and Number is an integer that is unique within the collection of shapes on the slide. For example, the automatically generated names of the shapes on a slide could be Placeholder 1, Oval 2, and Rectangle 3. To avoid conflict with automatically assigned names, do not use the form ShapeType Number for user-defined names, where ShapeType is a value that is used for automatically generated names, and Number is any positive integer. A shape range must contain exactly one shape. Read/write.
	Nodes	Returns a ShapeNodes collection that represents the geometric description of the specified shape. Applies to Shape objects that represent freeform drawings.
	OLEFormat	Returns an OLEFormat object that contains OLE formatting properties for the specified shape. Applies to Shape or ShapeRange objects that represent OLE objects. Read-only.
	Parent	Returns the parent object for the specified object.
	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. Read-only.
	PlaceholderFormat	Returns a PlaceholderFormat object that contains the properties that are unique to placeholders. Read-only.
	Reflection	Returns the reflection format for the specified shape. Read-only.
	Rotation	Returns or sets the number of degrees the specified shape is rotated around the z-axis. Read/write.
	RTF	Reserved for internal use.
	Script	Reserved for internal use.
	Shadow	Returns a ShadowFormat object that contains shadow formatting properties for the specified shape. Read-only.
	ShapeStyle	Sets or returns the shape style index for the specified object. Read/write.
	SmartArt	Returns the SmartArt diagram of the Shape object. Read-only.
	SoftEdge	Returns the soft edge format for the specified shape. Read-only.
	SoundFormat	Reserved for internal use.
	Table	Returns a Table object that represents a table in a shape or in a shape range. Read-only.
	Tags	Returns a Tags object that represents the tags for the specified object. 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 or master text style.
	TextFrame2	Returns the TextFrame2 object that is associated with the specified Shape object that contains the alignment and anchoring properties 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 a Shape object that represents the slide title. Read-only.
	Top	Returns or sets a single-precision floating-point number that represents the distance from the top edge of the shape's bounding box to the top edge of the document. Read/write.
	Type	Represents the type of shape or shapes in a range of shapes. Read-only.
	VerticalFlip	Determines whether the specified shape is flipped around the vertical axis. Read-only.
	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.
	Visible	Returns or sets the visibility of the specified object or the formatting applied to the specified object. Read/write.
	Width	Returns or sets the width of the specified object, in points. Read/write.
	ZOrderPosition	Returns the position of the specified shape in the z-order. Read-only.

Top

Methods

	Name	Description
	Apply	Applies to the specified shape formatting that's been copied by using the PickUp() method.
	ApplyAnimation	Applies the last picked up animation to the Shape object.
	CanvasCropBottom	Reserved for internal use.
	CanvasCropLeft	Reserved for internal use.
	CanvasCropRight	Reserved for internal use.
	CanvasCropTop	Reserved for internal use.
	ConvertTextToSmartArt	Converts text in a Shape object to a SmartArt diagram.
	Copy	Copies the specified object to the Clipboard.
	Cut	Deletes the specified object and places it on the Clipboard.
	Delete	Deletes the specified Shape object.
	Duplicate	Creates a duplicate of the specified Shape object, adds the new shape to the Shapes collection, and then returns a new ShapeRange object. The duplicated objects are placed at the end of the Shapes collection.
	Export	Reserved for internal use.
	Flip	Flips the specified shape around its horizontal or vertical axis.
	IncrementLeft	Moves the specified shape horizontally by the specified number of points.
	IncrementRotation	Changes the rotation of the specified shape around the z-axis by the specified number of degrees. Use the Rotation property to set the absolute rotation of the shape.
	IncrementTop	Moves the specified shape vertically by the specified number of points.
	PickUp	Copies the formatting of the specified shape. Use the Apply() method to apply the copied formatting to another shape.
	PickupAnimation	Picks up all animation from the Shape object.
	RerouteConnections	Reroutes connectors so that they take the shortest possible path between the shapes they connect. To do this, the RerouteConnections() method may detach the ends of a connector and reattach them to different connecting sites on the connected shapes.
	ScaleHeight	Scales the height of the shape by a specified factor.
	ScaleWidth	Scales the width of the shape by a specified factor. For pictures and OLE objects, you can indicate whether you want to scale the shape relative to the original size or relative to the current size. Shapes other than pictures and OLE objects are always scaled relative to their current width.
	Select	Selects the specified object.
	SetShapesDefaultProperties	Applies the formatting for the specified shape to the default shape. Shapes that are created after this method has been used will have this formatting applied to them by default.
	Ungroup	Ungroups any grouped shapes in the specified shape or range of shapes. Disassembles pictures and OLE objects within the specified shape or range of shapes. Returns the ungrouped shapes as a single ShapeRange object.
	UpgradeMedia	Converts a legacy media object to an updated media object.
	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

See Also

Reference

Shape Interface

Microsoft.Office.Interop.PowerPoint Namespace