Edit

Share via


PowerPoint.Interfaces.ShapeUpdateData interface

An interface for updating data on the Shape object, for use in shape.set({ ... }).

Properties

altTextDescription

The alt text description of the Shape.

Alt text provides alternative, text-based representations of the information contained in the Shape. This information is useful for people with vision or cognitive impairments who may not be able to see or understand the shape.

altTextTitle

The alt text title of the Shape.

Alt text provides alternative, text-based representations of the information contained in the Shape. This information is useful for people with vision or cognitive impairments who may not be able to see or understand the shape. A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.

height

Specifies the height, in points, of the shape. Throws an InvalidArgument exception when set with a negative value.

isDecorative

Represents whether the shape is decorative or not.

Decorative objects add visual interest but aren't informative (e.g. stylistic borders). People using screen readers will hear these are decorative so they know they aren't missing any important information.

left

The distance, in points, from the left side of the shape to the left side of the slide.

name

Specifies the name of this shape.

rotation

Specifies the rotation, in degrees, of the shape around the z-axis. A positive value indicates clockwise rotation, and a negative value indicates counterclockwise rotation.

top

The distance, in points, from the top edge of the shape to the top edge of the slide.

visible

Specifies if the shape is visible.

width

Specifies the width, in points, of the shape. Throws an InvalidArgument exception when set with a negative value.

Property Details

altTextDescription

Note

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

The alt text description of the Shape.

Alt text provides alternative, text-based representations of the information contained in the Shape. This information is useful for people with vision or cognitive impairments who may not be able to see or understand the shape.

altTextDescription?: string;

Property Value

string

Remarks

[ API set: PowerPointApi BETA (PREVIEW ONLY) ]

altTextTitle

Note

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

The alt text title of the Shape.

Alt text provides alternative, text-based representations of the information contained in the Shape. This information is useful for people with vision or cognitive impairments who may not be able to see or understand the shape. A title can be read to a person with a disability and is used to determine whether they wish to hear the description of the content.

altTextTitle?: string;

Property Value

string

Remarks

[ API set: PowerPointApi BETA (PREVIEW ONLY) ]

height

Specifies the height, in points, of the shape. Throws an InvalidArgument exception when set with a negative value.

height?: number;

Property Value

number

Remarks

[ API set: PowerPointApi 1.4 ]

isDecorative

Note

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

Represents whether the shape is decorative or not.

Decorative objects add visual interest but aren't informative (e.g. stylistic borders). People using screen readers will hear these are decorative so they know they aren't missing any important information.

isDecorative?: boolean;

Property Value

boolean

Remarks

[ API set: PowerPointApi BETA (PREVIEW ONLY) ]

left

The distance, in points, from the left side of the shape to the left side of the slide.

left?: number;

Property Value

number

Remarks

[ API set: PowerPointApi 1.4 ]

name

Specifies the name of this shape.

name?: string;

Property Value

string

Remarks

[ API set: PowerPointApi 1.4 ]

rotation

Note

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

Specifies the rotation, in degrees, of the shape around the z-axis. A positive value indicates clockwise rotation, and a negative value indicates counterclockwise rotation.

rotation?: number;

Property Value

number

Remarks

[ API set: PowerPointApi BETA (PREVIEW ONLY) ]

top

The distance, in points, from the top edge of the shape to the top edge of the slide.

top?: number;

Property Value

number

Remarks

[ API set: PowerPointApi 1.4 ]

visible

Note

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

Specifies if the shape is visible.

visible?: boolean;

Property Value

boolean

Remarks

[ API set: PowerPointApi BETA (PREVIEW ONLY) ]

width

Specifies the width, in points, of the shape. Throws an InvalidArgument exception when set with a negative value.

width?: number;

Property Value

number

Remarks

[ API set: PowerPointApi 1.4 ]