Share via


ShapeRange Members

Include Protected Members
Include Inherited Members

Represents a shape range, which is a set of shapes on a document. A shape range can contain as few as a single shape or as many as all the shapes on the document.

The ShapeRange type exposes the following members.

Properties

  Name Description
Public property 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.
Public property Adjustments Returns an Adjustments object that contains adjustment values for all the adjustments in the specified shape. Applies to any ShapeRange object that represents an AutoShape, WordArt, or a connector. Read-only.
Public property AlternativeText Returns or sets the alternative text associated with a shape in a Web presentation. Read/write.
Public property AnimationSettings Returns an AnimationSettings object that represents all the special affects you can apply to the animation of the specified shape. Read-only.
Public property Application Returns an Application object that represents the creator of the specified object.
Public property AutoShapeType Returns or sets the shape type for the specified ShapeRange object, which must represent an AutoShape other than a line, freeform drawing, or connector. Read/write.
Public property BackgroundStyle Sets or returns the background style of the specified object. Read/write.
Public property 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.
Public property Callout Returns a CalloutFormatobject that contains callout formatting properties for the specified shape. Applies to Shape or ShapeRange objects that represent line callouts. Read-only.
Public property CanvasItems Reserved for internal use.
Public property Chart Returns the Chart object of the current ShapeRange object. Read-only.
Public property 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.
Public property ConnectionSiteCount Returns the number of connection sites on the specified shape. Read-only.
Public property Connector Determines whether the specified shape is a connector. Read-only.
Public property ConnectorFormat Returns a ConnectorFormatobject that contains connector formatting properties. Applies to Shape or ShapeRange objects that represent connectors. Read-only.
Public property Count Returns the number of objects in the specified collection. Read-only.
Public property 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.
Public property CustomerData Returns a CustomerData object.
Public property Diagram Reserved for internal use.
Public property DiagramNode Reserved for internal use.
Public property Fill Returns a FillFormat object that contains fill formatting properties for the specified shape. Read-only.
Public property Glow Returns the glow format for the specified range of shapes. Read-only.
Public property 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. Read-only.
Public property HasChart Returns whether the shape range represented by the specified object contains a chart. Read-only.
Public property HasDiagram Reserved for internal use.
Public property HasDiagramNode Reserved for internal use.
Public property HasSmartArt Returns true if the current ShapeRange object has a SmartArt diagram. Read-only.
Public property HasTable Returns whether the specified shape is a table. Read-only.
Public property HasTextFrame Returns whether the specified shape has a text frame. Read-only.
Public property Height Returns or sets the height of the specified object, in points. Read/write.
Public property HorizontalFlip Returns whether the specified shape is flipped around the horizontal axis. Read-only.
Public property Id Returns a 64-bit signed integer that identifies the shape or range of shapes. Read-only.
Public property Item Returns a single Shape object from the specified ShapeRange collection.
Public property Left Returns or sets the distance in points from the left edge of the leftmost shape in the shape range to the left edge of the slide. Read/write.
Public property 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.
Public property LinkFormat Returns a LinkFormat object that contains the properties that are unique to linked OLE objects. Read-only.
Public property LockAspectRatio Determines whether the specified shape retains its original proportions when you resize it. Read/write.
Public property MediaFormat Returns the current MediaFormat object. Read-only.
Public property MediaType Returns the OLE media type. Read-only.
Public property Name Returns the name of the Shape object. Read-only.
Public property Nodes Returns a ShapeNodes collection that represents the geometric description of the specified shape. Applies to ShapeRange objects that represent freeform drawings.
Public property 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.
Public property Parent Returns the parent object for the specified object.
Public property ParentGroup Returns a Shape object that represents the common parent shape of a child shape or a range of child shapes.
Public property PictureFormat Returns a PictureFormat object that contains picture formatting properties for the specified shape. Read-only.
Public property PlaceholderFormat Returns a PlaceholderFormat object that contains the properties that are unique to placeholders. Read-only.
Public property Reflection Returns the reflection format for the specified range of shapes. Read-only.
Public property Rotation Returns or sets the number of degrees the specified shape is rotated around the z-axis . Read/write.
Public property RTF Reserved for internal use.
Public property Script Reserved for internal use.
Public property Shadow Returns a ShadowFormat object that contains shadow formatting properties for the specified shapes. Read-only.
Public property ShapeStyle Sets or returns the shape style index for the specified object.
Public property SmartArt Returns the SmartArt diagram of the ShapeRange object. Read-only.
Public property SoftEdge Returns the soft edge format for the specified range of shapes. Read-only.
Public property SoundFormat Reserved for internal use.
Public property Table Returns a Table object that represents a table in a shape or in a shape range. Read-only.
Public property Tags Returns a Tags object that represents the tags for the specified object. Read-only.
Public property TextEffect Returns a TextEffectFormat object that contains text-effect formatting properties for the specified shape. Read-only.
Public property TextFrame Returns a TextFrame object that contains the alignment and anchoring properties for the specified shape or master text style. Read-only.
Public property TextFrame2 Returns the TextFrame2 object associated with the specified ShapeRange object that contains the alignment and anchoring properties for the specified shape range. Read-only.
Public property ThreeD Returns a ThreeDFormat object that contains 3-D – effect formatting properties for the specified shape. Read-only.
Public property Title Returns a Shape object that represents the slide title. Read-only.
Public property Top Returns or sets the distance from the top edge of the topmost shape in the shape range to the top edge of the document. Read/write.
Public property Type Represents the type of shape or shapes in a range of shapes. Read-only.
Public property VerticalFlip Determines whether the specified shape is flipped around the vertical axis. Read-only.
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. Read-only.
Public property Visible Returns or sets the visibility of the specified object or the formatting applied to the specified object. Read/write.
Public property Width Returns or sets the width of the specified object, in points. Read/write.
Public property ZOrderPosition Returns the position of the specified shape in the z-order. Read-only.

Top

Methods

  Name Description
Public method _Index Reserved for internal use.
Public method Align Aligns the shapes in the specified range of shapes.
Public method Apply Applies to the specified shape range formatting that's been copied by using the PickUp method.
Public method ApplyAnimation Applies animation to a ShapeRange object.
Public method CanvasCropBottom Reserved for internal use.
Public method CanvasCropLeft Reserved for internal use.
Public method CanvasCropRight Reserved for internal use.
Public method CanvasCropTop Reserved for internal use.
Public method ConvertTextToSmartArt Returns the number of objects in the specified collection. Read-only.
Public method Copy Copies the specified object to the Clipboard.
Public method Cut Deletes the specified object and places it on the Clipboard.
Public method Delete Deletes the specified ShapeRange object.
Public method Distribute Evenly distributes the shapes in the specified range of shapes. You can specify whether you want to distribute the shapes horizontally or vertically and whether you want to distribute them over the entire slide or just over the space they originally occupy.
Public method Duplicate Creates a duplicate of the specified ShapeRange object, adds the range of shapes to the Shapes collection, and then returns the new ShapeRange object. The duplicated objects are placed at the end of the Shapes collection.
Public method Export Reserved for internal use.
Public method Flip Flips the specified shape range around its horizontal or vertical axis.
Public method GetEnumerator() (Inherited from IEnumerable.)
Public method GetEnumerator() Returns an enumerator that iterates through a shape range.
Public method GetPolygonalRepresentation Reserved for internal use.
Public method Group Groups the shapes in the specified range. Returns the grouped shapes as a single Shape object.
Public method IncrementLeft Moves the specified shape range horizontally by the specified number of points.
Public method IncrementRotation Changes the rotation of the specified shape range around the z-axis  by the specified number of degrees. Use the Rotation property to set the absolute rotation of the shape range.
Public method IncrementTop Moves the specified shape range vertically by the specified number of points.
Public method PickUp Copies the formatting of the specified shape. Use the Apply method to apply the copied formatting to another shape.
Public method PickupAnimation Picks up all animation from the ShapeRange object.
Public method Regroup Regroups the group that the specified shape range belonged to previously. Returns the regrouped shapes as a single Shape object.
Public method 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.
Public method ScaleHeight Scales the height of the shapes in the range by a specified factor.
Public method ScaleWidth Scales the width of the shapes in the range by a specified factor.
Public method Select Selects the specified object.
Public method SetShapesDefaultProperties Applies the formatting for the specified shape to the DefaultShape. Shapes created after this method has been used will have this formatting applied to them by default.
Public method 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.
Public method UpgradeMedia Upgrades media within the specified ShapeRange object.
Public method ZOrder Moves the specified shape range in front of or behind other shapes in the collection (that is, changes the shape range's position in the z-order).

Top

See Also

Reference

ShapeRange Interface

Microsoft.Office.Interop.PowerPoint Namespace