Compartilhar via


PowerPoint.Interfaces.ShapeData interface

Uma interface que descreve os dados devolvidos ao chamar shape.toJSON().

Propriedades

altTextDescription

A descrição do texto alternativo da Forma.

O texto alternativo fornece representações alternativas baseadas em texto das informações contidas na Forma. Estas informações são úteis para pessoas com deficiências visuais ou cognitivas que podem não conseguir ver ou compreender a forma.

altTextTitle

O título do texto alternativo da Forma.

O texto alternativo fornece representações alternativas baseadas em texto das informações contidas na Forma. Estas informações são úteis para pessoas com deficiências visuais ou cognitivas que podem não conseguir ver ou compreender a forma. Um título pode ser lido para uma pessoa portadora de deficiência e é utilizado para determinar se pretende ouvir a descrição do conteúdo.

creationId

Obtém o ID de criação da forma. Devolve null se a forma não tiver um ID de criação.

height

Especifica a altura, em pontos, da forma. Lança uma exceção InvalidArgument quando definida com um valor negativo.

id

Obtém o ID exclusivo da forma.

isDecorative

Representa se a forma é decorativa ou não.

Os objetos decorativos acrescentam interesse visual, mas não são informativos (por exemplo, limites estilísticos). Pessoas que utilizam leitores de ecrã irão ouvir que são decorativos para saberem que não faltam informações importantes.

left

A distância, em pontos, do lado esquerdo da forma para o lado esquerdo do diapositivo.

level

Devolve o nível da forma especificada.

  • Um nível de 0 significa que a forma não faz parte de um grupo.

  • Um nível de 1 significa que a forma faz parte de um grupo de nível superior.

  • Um nível superior a 1 indica que a forma é um grupo aninhado.

name

Especifica o nome desta forma.

rotation

Especifica a rotação, em graus, da forma à volta do eixo z. Um valor positivo indica rotação no sentido dos ponteiros do relógio e um valor negativo indica rotação para a esquerda.

top

A distância, em pontos, desde a margem superior da forma até à margem superior do diapositivo.

type

Retorna o tipo dessa forma. Consulte PowerPoint.ShapeType para obter detalhes.

visible

Especifica se a forma está visível.

width

Especifica a largura, em pontos, da forma. Lança uma exceção InvalidArgument quando definida com um valor negativo.

zOrderPosition

Devolve a posição z-order da forma, com 0 a representar a parte inferior da pilha de encomendas. Cada forma num diapositivo tem uma ordem z exclusiva, mas cada diapositivo também tem uma pilha de ordenação z exclusiva, pelo que duas formas em diapositivos separados podem ter o mesmo número de ordenação z.

Detalhes da propriedade

altTextDescription

A descrição do texto alternativo da Forma.

O texto alternativo fornece representações alternativas baseadas em texto das informações contidas na Forma. Estas informações são úteis para pessoas com deficiências visuais ou cognitivas que podem não conseguir ver ou compreender a forma.

altTextDescription?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

altTextTitle

O título do texto alternativo da Forma.

O texto alternativo fornece representações alternativas baseadas em texto das informações contidas na Forma. Estas informações são úteis para pessoas com deficiências visuais ou cognitivas que podem não conseguir ver ou compreender a forma. Um título pode ser lido para uma pessoa portadora de deficiência e é utilizado para determinar se pretende ouvir a descrição do conteúdo.

altTextTitle?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

creationId

Obtém o ID de criação da forma. Devolve null se a forma não tiver um ID de criação.

creationId?: string | null;

Valor da propriedade

string | null

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

height

Especifica a altura, em pontos, da forma. Lança uma exceção InvalidArgument quando definida com um valor negativo.

height?: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

id

Obtém o ID exclusivo da forma.

id?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: PowerPointApi 1.3 ]

isDecorative

Representa se a forma é decorativa ou não.

Os objetos decorativos acrescentam interesse visual, mas não são informativos (por exemplo, limites estilísticos). Pessoas que utilizam leitores de ecrã irão ouvir que são decorativos para saberem que não faltam informações importantes.

isDecorative?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

left

A distância, em pontos, do lado esquerdo da forma para o lado esquerdo do diapositivo.

left?: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

level

Devolve o nível da forma especificada.

  • Um nível de 0 significa que a forma não faz parte de um grupo.

  • Um nível de 1 significa que a forma faz parte de um grupo de nível superior.

  • Um nível superior a 1 indica que a forma é um grupo aninhado.

level?: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: PowerPointApi 1.8 ]

name

Especifica o nome desta forma.

name?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

rotation

Especifica a rotação, em graus, da forma à volta do eixo z. Um valor positivo indica rotação no sentido dos ponteiros do relógio e um valor negativo indica rotação para a esquerda.

rotation?: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

top

A distância, em pontos, desde a margem superior da forma até à margem superior do diapositivo.

top?: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

type

Retorna o tipo dessa forma. Consulte PowerPoint.ShapeType para obter detalhes.

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

Valor da propriedade

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

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

visible

Especifica se a forma está visível.

visible?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

width

Especifica a largura, em pontos, da forma. Lança uma exceção InvalidArgument quando definida com um valor negativo.

width?: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

zOrderPosition

Devolve a posição z-order da forma, com 0 a representar a parte inferior da pilha de encomendas. Cada forma num diapositivo tem uma ordem z exclusiva, mas cada diapositivo também tem uma pilha de ordenação z exclusiva, pelo que duas formas em diapositivos separados podem ter o mesmo número de ordenação z.

zOrderPosition?: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: PowerPointApi 1.8 ]