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 | |
|---|---|---|
.gif "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. |
|
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. |
|
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 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 ShapeRange 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 | |
|
Chart | |
|
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. |
|
Count | Returns the number of objects in the specified collection. Read-only. |
|
Creator | Returns a Long 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 Office PowerPoint, this property returns the hexadecimal number 50575054. Read-only. |
|
CustomerData | Returns a [CustomerData#SameCHM] object. |
|
Diagram | |
|
DiagramNode | |
|
Fill | Returns a ChartFillFormat object that contains fill formatting properties for the specified shape. Read-only. |
|
Glow | Returns the glow format for the specified range of shapes. 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. Read-only. |
|
HasChart | Returns whether the shape range represented by the specified object contains a chart. Read-only. |
|
HasDiagram | |
|
HasDiagramNode | |
|
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 Long that identifies the shape or range of shapes. Read-only. |
|
Item | Returns a single Shape object from the specified ShapeRange collection. |
|
Left | Returns or sets a Single that represents 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. |
|
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. |
|
MediaType | Returns the OLE media type. Read-only. |
|
Name | When a shape is created, Microsoft Office 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's 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, don't 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 ShapeRange 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 range of shapes. Read-only. |
|
Rotation | Returns or sets the number of degrees the specified shape is rotated around the z-axis. Read/write. |
|
RTF | |
|
Script | Returns a Script object that represents a block of script code on a Microsoft Office PowerPoint slide. Read-only. |
|
Shadow | Returns a ShadowFormat object that contains shadow formatting properties for the specified shapes. Read-only. |
|
ShapeStyle | Sets or returns the shape style index for the specified object. |
|
SoftEdge | Returns the soft edge format for the specified range of shapes. Read-only. |
|
SoundFormat | |
|
Table | Returns a DataTable 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. Read-only. |
|
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. |
|
ThreeD | Returns a ThreeDFormat object that contains 3-D – effect formatting properties for the specified shape. Read-only. |
|
Top | Returns or sets a Single that represents the distance from the top edge of the topmost shape in the shape range 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 | |
|---|---|---|
.gif "Public method") |
_Index | |
|
Align | |
|
Apply | Applies to the specified shape range formatting that's been copied by using the PickUp method. |
|
CanvasCropBottom | |
|
CanvasCropLeft | |
|
CanvasCropRight | |
|
CanvasCropTop | |
|
Copy | Copies the specified object to the Clipboard. |
|
Cut | Deletes the specified object and places it on the Clipboard. |
|
Delete | Deletes the specified ShapeRange object. |
|
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. |
|
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. |
|
Export | |
|
Flip | Flips the specified shape range around its horizontal or vertical axis. |
|
GetEnumerator() | (Inherited from IEnumerable.) |
|
GetEnumerator() | |
|
GetPolygonalRepresentation | |
|
Group | |
|
IncrementLeft | Moves the specified shape range horizontally by the specified number of points. |
|
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. |
|
IncrementTop | Moves the specified shape range 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. |
|
Regroup | Regroups the group that the specified shape range belonged to previously. Returns the regrouped shapes as a single 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 shapes in the range by a specified factor. |
|
ScaleWidth | Scales the width of the shapes in the range by a specified factor. |
|
Select | Selects the specified object. |
|
SetShapesDefaultProperties | Applies the formatting for the specified shape to the default shape. Shapes 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. |
|
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