Compartilhar via


PowerPoint.Interfaces.ShapeLoadOptions interface

Representa uma única forma no diapositivo.

Comentários

[ Conjunto de API: PowerPointApi 1.3 ]

Propriedades

$all

Especificar $all para as opções de carga carrega todas as propriedades escalares (como Range.address) mas não as propriedades de navegação (como Range.format.fill.color).

adjustments

Devolve um Adjustments objeto que contém valores de ajuste para todos os ajustes nesta forma.

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.

fill

Retorna a formatação de preenchimento dessa forma.

group

Devolve o ShapeGroup associado à forma. Se o tipo de forma não groupfor , este método devolve o GeneralException erro.

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.

lineFormat

Retorna a formatação de linha do objeto de forma.

name

Especifica o nome desta forma.

parentGroup

Devolve o grupo principal desta forma. Se a forma não fizer parte de um grupo, este método devolve o GeneralException erro.

placeholderFormat

Devolve as propriedades que se aplicam especificamente a este marcador de posição. Se o tipo de forma não placeholderfor , este método devolve o GeneralException erro.

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.

textFrame

Devolve o objeto PowerPoint.TextFrame deste Shape. Gera uma exceção InvalidArgument se a forma não suportar um TextFrame.

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

$all

Especificar $all para as opções de carga carrega todas as propriedades escalares (como Range.address) mas não as propriedades de navegação (como Range.format.fill.color).

$all?: boolean;

Valor da propriedade

boolean

adjustments

Devolve um Adjustments objeto que contém valores de ajuste para todos os ajustes nesta forma.

adjustments?: PowerPoint.Interfaces.AdjustmentsLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

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?: boolean;

Valor da propriedade

boolean

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?: boolean;

Valor da propriedade

boolean

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?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

fill

Retorna a formatação de preenchimento dessa forma.

fill?: PowerPoint.Interfaces.ShapeFillLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

group

Devolve o ShapeGroup associado à forma. Se o tipo de forma não groupfor , este método devolve o GeneralException erro.

group?: PowerPoint.Interfaces.ShapeGroupLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.8 ]

height

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

height?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

id

Obtém o ID exclusivo da forma.

id?: boolean;

Valor da propriedade

boolean

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?: boolean;

Valor da propriedade

boolean

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?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: PowerPointApi 1.8 ]

lineFormat

Retorna a formatação de linha do objeto de forma.

lineFormat?: PowerPoint.Interfaces.ShapeLineFormatLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

name

Especifica o nome desta forma.

name?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

parentGroup

Devolve o grupo principal desta forma. Se a forma não fizer parte de um grupo, este método devolve o GeneralException erro.

parentGroup?: PowerPoint.Interfaces.ShapeLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.8 ]

placeholderFormat

Devolve as propriedades que se aplicam especificamente a este marcador de posição. Se o tipo de forma não placeholderfor , este método devolve o GeneralException erro.

placeholderFormat?: PowerPoint.Interfaces.PlaceholderFormatLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.8 ]

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?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: PowerPointApi 1.10 ]

textFrame

Devolve o objeto PowerPoint.TextFrame deste Shape. Gera uma exceção InvalidArgument se a forma não suportar um TextFrame.

textFrame?: PowerPoint.Interfaces.TextFrameLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

top

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

top?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: PowerPointApi 1.4 ]

type

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

type?: boolean;

Valor da propriedade

boolean

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?: boolean;

Valor da propriedade

boolean

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?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: PowerPointApi 1.8 ]