Compartir a través de


PowerPoint.Interfaces.ShapeData interface

Interfaz que describe los datos devueltos mediante una llamada a shape.toJSON().

Propiedades

altTextDescription

Descripción del texto alternativo de la forma.

El texto alternativo proporciona representaciones alternativas basadas en texto de la información contenida en la forma. Esta información es útil para las personas con discapacidades visuales o cognitivas que pueden no ser capaces de ver o entender la forma.

altTextTitle

Título de texto alternativo de la forma.

El texto alternativo proporciona representaciones alternativas basadas en texto de la información contenida en la forma. Esta información es útil para las personas con discapacidades visuales o cognitivas que pueden no ser capaces de ver o entender la forma. Un título se puede leer a una persona con una discapacidad y se usa para determinar si desea escuchar la descripción del contenido.

creationId

Obtiene el identificador de creación de la forma. Devuelve null si la forma no tiene ningún identificador de creación.

height

Especifica el alto, en puntos, de la forma. Produce una InvalidArgument excepción cuando se establece con un valor negativo.

id

Obtiene el identificador único de la forma.

isDecorative

Representa si la forma es decorativa o no.

Los objetos decorativos agregan interés visual, pero no son informativos (por ejemplo, bordes estilísticos). Personas el uso de lectores de pantalla escuchará que son decorativos para que sepan que no les falta información importante.

left

Distancia, en puntos, desde el lado izquierdo de la forma hasta el lado izquierdo de la diapositiva.

level

Devuelve el nivel de la forma especificada.

  • Un nivel de 0 significa que la forma no forma parte de un grupo.

  • Un nivel de 1 significa que la forma forma parte de un grupo de nivel superior.

  • Un nivel mayor que 1 indica que la forma es un grupo anidado.

name

Especifica el nombre de esta forma.

rotation

Especifica la rotación, en grados, de la forma alrededor del eje Z. Un valor positivo indica la rotación en el sentido de las agujas del reloj y un valor negativo indica la rotación en sentido contrario a las agujas del reloj.

top

Distancia, en puntos, desde el borde superior de la forma hasta el borde superior de la diapositiva.

type

Devuelve el tipo de esta forma. Vea PowerPoint.ShapeType para obtener más información.

visible

Especifica si la forma está visible.

width

Especifica el ancho, en puntos, de la forma. Produce una InvalidArgument excepción cuando se establece con un valor negativo.

zOrderPosition

Devuelve la posición de orden Z de la forma, con 0 que representa la parte inferior de la pila de pedidos. Cada forma de una diapositiva tiene un orden Z único, pero cada diapositiva también tiene una pila de orden Z única, por lo que dos formas en diapositivas independientes podrían tener el mismo número de orden Z.

Detalles de las propiedades

altTextDescription

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

Descripción del texto alternativo de la forma.

El texto alternativo proporciona representaciones alternativas basadas en texto de la información contenida en la forma. Esta información es útil para las personas con discapacidades visuales o cognitivas que pueden no ser capaces de ver o entender la forma.

altTextDescription?: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: PowerPointApi BETA (SOLO VERSIÓN PRELIMINAR) ]

altTextTitle

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

Título de texto alternativo de la forma.

El texto alternativo proporciona representaciones alternativas basadas en texto de la información contenida en la forma. Esta información es útil para las personas con discapacidades visuales o cognitivas que pueden no ser capaces de ver o entender la forma. Un título se puede leer a una persona con una discapacidad y se usa para determinar si desea escuchar la descripción del contenido.

altTextTitle?: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: PowerPointApi BETA (SOLO VERSIÓN PRELIMINAR) ]

creationId

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

Obtiene el identificador de creación de la forma. Devuelve null si la forma no tiene ningún identificador de creación.

creationId?: string | null;

Valor de propiedad

string | null

Comentarios

[ Conjunto de API: PowerPointApi BETA (SOLO VERSIÓN PRELIMINAR) ]

height

Especifica el alto, en puntos, de la forma. Produce una InvalidArgument excepción cuando se establece con un valor negativo.

height?: number;

Valor de propiedad

number

Comentarios

[ Conjunto de API: PowerPointApi 1.4 ]

id

Obtiene el identificador único de la forma.

id?: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: PowerPointApi 1.3 ]

isDecorative

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

Representa si la forma es decorativa o no.

Los objetos decorativos agregan interés visual, pero no son informativos (por ejemplo, bordes estilísticos). Personas el uso de lectores de pantalla escuchará que son decorativos para que sepan que no les falta información importante.

isDecorative?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: PowerPointApi BETA (SOLO VERSIÓN PRELIMINAR) ]

left

Distancia, en puntos, desde el lado izquierdo de la forma hasta el lado izquierdo de la diapositiva.

left?: number;

Valor de propiedad

number

Comentarios

[ Conjunto de API: PowerPointApi 1.4 ]

level

Devuelve el nivel de la forma especificada.

  • Un nivel de 0 significa que la forma no forma parte de un grupo.

  • Un nivel de 1 significa que la forma forma parte de un grupo de nivel superior.

  • Un nivel mayor que 1 indica que la forma es un grupo anidado.

level?: number;

Valor de propiedad

number

Comentarios

[ Conjunto de API: PowerPointApi 1.8 ]

name

Especifica el nombre de esta forma.

name?: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: PowerPointApi 1.4 ]

rotation

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

Especifica la rotación, en grados, de la forma alrededor del eje Z. Un valor positivo indica la rotación en el sentido de las agujas del reloj y un valor negativo indica la rotación en sentido contrario a las agujas del reloj.

rotation?: number;

Valor de propiedad

number

Comentarios

[ Conjunto de API: PowerPointApi BETA (SOLO VERSIÓN PRELIMINAR) ]

top

Distancia, en puntos, desde el borde superior de la forma hasta el borde superior de la diapositiva.

top?: number;

Valor de propiedad

number

Comentarios

[ Conjunto de API: PowerPointApi 1.4 ]

type

Devuelve el tipo de esta forma. Vea PowerPoint.ShapeType para obtener más información.

type?: PowerPoint.ShapeType | "Unsupported" | "Image" | "GeometricShape" | "Group" | "Line" | "Table" | "Callout" | "Chart" | "ContentApp" | "Diagram" | "Freeform" | "Graphic" | "Ink" | "Media" | "Model3D" | "Ole" | "Placeholder" | "SmartArt" | "TextBox";

Valor de propiedad

PowerPoint.ShapeType | "Unsupported" | "Image" | "GeometricShape" | "Group" | "Line" | "Table" | "Callout" | "Chart" | "ContentApp" | "Diagram" | "Freeform" | "Graphic" | "Ink" | "Media" | "Model3D" | "Ole" | "Placeholder" | "SmartArt" | "TextBox"

Comentarios

[ Conjunto de API: PowerPointApi 1.4 ]

visible

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

Especifica si la forma está visible.

visible?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: PowerPointApi BETA (SOLO VERSIÓN PRELIMINAR) ]

width

Especifica el ancho, en puntos, de la forma. Produce una InvalidArgument excepción cuando se establece con un valor negativo.

width?: number;

Valor de propiedad

number

Comentarios

[ Conjunto de API: PowerPointApi 1.4 ]

zOrderPosition

Devuelve la posición de orden Z de la forma, con 0 que representa la parte inferior de la pila de pedidos. Cada forma de una diapositiva tiene un orden Z único, pero cada diapositiva también tiene una pila de orden Z única, por lo que dos formas en diapositivas independientes podrían tener el mismo número de orden Z.

zOrderPosition?: number;

Valor de propiedad

number

Comentarios

[ Conjunto de API: PowerPointApi 1.8 ]