Ask Learn
Preview
Ask Learn is an AI assistant that can answer questions, clarify concepts, and define terms using trusted Microsoft documentation.
Please sign in to use Ask Learn.
Sign inThis browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
An interface describing the data returned by calling shape.toJSON()
.
height | Specifies the height, in points, of the shape. Throws an |
id | Gets the unique ID of the shape. |
left | The distance, in points, from the left side of the shape to the left side of the slide. |
level | Returns the level of the specified shape.
|
name | Specifies the name of this shape. |
top | The distance, in points, from the top edge of the shape to the top edge of the slide. |
type | Returns the type of this shape. See PowerPoint.ShapeType for details. |
width | Specifies the width, in points, of the shape. Throws an |
z |
Returns the z-order position of the shape, with 0 representing the bottom of the order stack. Every shape on a slide has a unique z-order, but each slide also has a unique z-order stack, so two shapes on separate slides could have the same z-order number. |
Specifies the height, in points, of the shape. Throws an InvalidArgument
exception when set with a negative value.
height?: number;
number
Gets the unique ID of the shape.
id?: string;
string
The distance, in points, from the left side of the shape to the left side of the slide.
left?: number;
number
Returns the level of the specified shape.
A level of 0 means the shape isn't part of a group.
A level of 1 means the shape is part of a top-level group.
A level greater than 1 indicates the shape is a nested group.
level?: number;
number
Specifies the name of this shape.
name?: string;
string
The distance, in points, from the top edge of the shape to the top edge of the slide.
top?: number;
number
Returns the type of this shape. See PowerPoint.ShapeType for details.
type?: PowerPoint.ShapeType | "Unsupported" | "Image" | "GeometricShape" | "Group" | "Line" | "Table" | "Callout" | "Chart" | "ContentApp" | "Diagram" | "Freeform" | "Graphic" | "Ink" | "Media" | "Model3D" | "Ole" | "Placeholder" | "SmartArt" | "TextBox";
PowerPoint.ShapeType | "Unsupported" | "Image" | "GeometricShape" | "Group" | "Line" | "Table" | "Callout" | "Chart" | "ContentApp" | "Diagram" | "Freeform" | "Graphic" | "Ink" | "Media" | "Model3D" | "Ole" | "Placeholder" | "SmartArt" | "TextBox"
Specifies the width, in points, of the shape. Throws an InvalidArgument
exception when set with a negative value.
width?: number;
number
Returns the z-order position of the shape, with 0 representing the bottom of the order stack. Every shape on a slide has a unique z-order, but each slide also has a unique z-order stack, so two shapes on separate slides could have the same z-order number.
zOrderPosition?: number;
number
Office Add-ins feedback
Office Add-ins is an open source project. Select a link to provide feedback:
Ask Learn is an AI assistant that can answer questions, clarify concepts, and define terms using trusted Microsoft documentation.
Please sign in to use Ask Learn.
Sign in