Compartilhar via


Excel.Interfaces.GroupShapeCollectionLoadOptions interface

Representa a coleção de formas dentro de um grupo de formas.

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

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).

altTextDescription

Para CADA ITEM na coleção: especifica o texto de descrição alternativo de um Shape objeto.

altTextTitle

Para CADA ITEM na coleção: especifica o texto de título alternativo para um Shape objeto.

connectionSiteCount

Para CADA ITEM na coleção: Devolve o número de sites de ligação nesta forma.

displayName

Para CADA ITEM na coleção: obtém o nome a apresentar da forma. Uma forma recentemente criada tem um nome gerado que é localizado e pode não corresponder ao respetivo name. Neste cenário, pode utilizar esta API para obter o nome que é apresentado na IU.

fill

Para CADA ITEM na coleção: Devolve a formatação de preenchimento desta forma.

geometricShape

Para CADA ITEM na coleção: Devolve a forma geométrica associada à forma. Um erro será lançado, se o tipo de forma não for "GeometricShape".

geometricShapeType

Para CADA ITEM na coleção: especifica o tipo de forma geométrica desta forma geométrica. Veja Excel.GeometricShapeType para obter detalhes. Devolve null se o tipo de forma não for "Forma Geométrica".

group

Para CADA ITEM na coleção: Devolve o grupo de formas associado à forma. Um erro será lançado, se o tipo de forma não for "GroupShape".

height

Para CADA ITEM na coleção: especifica a altura, em pontos, da forma. Gera uma exceção InvalidArgument quando definida com um valor negativo ou zero como entrada.

id

Para CADA ITEM na coleção: especifica o identificador da forma.

image

Para CADA ITEM na coleção: Devolve a imagem associada à forma. Um erro será lançado, se o tipo de forma não for "Imagem".

left

Para CADA ITEM na coleção: a distância, em pontos, do lado esquerdo da forma para o lado esquerdo da folha de cálculo. Lança uma exceção InvalidArgument quando definida com um valor negativo como entrada.

level

Para CADA ITEM na coleção: especifica o nível da forma especificada. Por exemplo, um nível de 0 significa que a forma não faz parte de nenhum grupo, um nível de 1 significa que a forma é parte de um grupo de nível superior e um nível 2 significa que a forma faz parte de um subgrupo do nível superior.

line

Para CADA ITEM na coleção: Devolve a linha associada à forma. Um erro será lançado, se o tipo de forma não for "Linha".

lineFormat

Para CADA ITEM na coleção: Devolve a formatação de linha desta forma.

lockAspectRatio

Para CADA ITEM na coleção: especifica se a proporção desta forma está bloqueada.

name

Para CADA ITEM na coleção: especifica o nome da forma.

parentGroup

Para CADA ITEM na coleção: especifica o grupo principal desta forma.

placement

Para CADA ITEM na coleção: representa a forma como o objeto é anexado às células abaixo do mesmo.

rotation

Para CADA ITEM na coleção: especifica a rotação, em graus, da forma.

textFrame

Para CADA ITEM na coleção: Devolve o objeto de moldura de texto desta forma.

top

Para CADA ITEM na coleção: a distância, em pontos, desde a margem superior da forma até à margem superior da folha de cálculo. Lança uma exceção InvalidArgument quando definida com um valor negativo como entrada.

type

Para CADA ITEM na coleção: Devolve o tipo desta forma. Veja Excel.ShapeType para obter detalhes.

visible

Para CADA ITEM na coleção: especifica se a forma está visível.

width

Para CADA ITEM na coleção: especifica a largura, em pontos, da forma. Gera uma exceção InvalidArgument quando definida com um valor negativo ou zero como entrada.

zOrderPosition

Para CADA ITEM na coleção: Devolve a posição da forma especificada na ordem z, com 0 a representar a parte inferior da pilha de encomendas.

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

altTextDescription

Para CADA ITEM na coleção: especifica o texto de descrição alternativo de um Shape objeto.

altTextDescription?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

altTextTitle

Para CADA ITEM na coleção: especifica o texto de título alternativo para um Shape objeto.

altTextTitle?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

connectionSiteCount

Para CADA ITEM na coleção: Devolve o número de sites de ligação nesta forma.

connectionSiteCount?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

displayName

Para CADA ITEM na coleção: obtém o nome a apresentar da forma. Uma forma recentemente criada tem um nome gerado que é localizado e pode não corresponder ao respetivo name. Neste cenário, pode utilizar esta API para obter o nome que é apresentado na IU.

displayName?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.15 ]

fill

Para CADA ITEM na coleção: Devolve a formatação de preenchimento desta forma.

fill?: Excel.Interfaces.ShapeFillLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

geometricShape

Para CADA ITEM na coleção: Devolve a forma geométrica associada à forma. Um erro será lançado, se o tipo de forma não for "GeometricShape".

geometricShape?: Excel.Interfaces.GeometricShapeLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

geometricShapeType

Para CADA ITEM na coleção: especifica o tipo de forma geométrica desta forma geométrica. Veja Excel.GeometricShapeType para obter detalhes. Devolve null se o tipo de forma não for "Forma Geométrica".

geometricShapeType?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

group

Para CADA ITEM na coleção: Devolve o grupo de formas associado à forma. Um erro será lançado, se o tipo de forma não for "GroupShape".

group?: Excel.Interfaces.ShapeGroupLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

height

Para CADA ITEM na coleção: especifica a altura, em pontos, da forma. Gera uma exceção InvalidArgument quando definida com um valor negativo ou zero como entrada.

height?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

id

Para CADA ITEM na coleção: especifica o identificador da forma.

id?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

image

Para CADA ITEM na coleção: Devolve a imagem associada à forma. Um erro será lançado, se o tipo de forma não for "Imagem".

image?: Excel.Interfaces.ImageLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

left

Para CADA ITEM na coleção: a distância, em pontos, do lado esquerdo da forma para o lado esquerdo da folha de cálculo. Lança uma exceção InvalidArgument quando definida com um valor negativo como entrada.

left?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

level

Para CADA ITEM na coleção: especifica o nível da forma especificada. Por exemplo, um nível de 0 significa que a forma não faz parte de nenhum grupo, um nível de 1 significa que a forma é parte de um grupo de nível superior e um nível 2 significa que a forma faz parte de um subgrupo do nível superior.

level?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

line

Para CADA ITEM na coleção: Devolve a linha associada à forma. Um erro será lançado, se o tipo de forma não for "Linha".

line?: Excel.Interfaces.LineLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

lineFormat

Para CADA ITEM na coleção: Devolve a formatação de linha desta forma.

lineFormat?: Excel.Interfaces.ShapeLineFormatLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

lockAspectRatio

Para CADA ITEM na coleção: especifica se a proporção desta forma está bloqueada.

lockAspectRatio?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

name

Para CADA ITEM na coleção: especifica o nome da forma.

name?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

parentGroup

Para CADA ITEM na coleção: especifica o grupo principal desta forma.

parentGroup?: Excel.Interfaces.ShapeLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

placement

Para CADA ITEM na coleção: representa a forma como o objeto é anexado às células abaixo do mesmo.

placement?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.10 ]

rotation

Para CADA ITEM na coleção: especifica a rotação, em graus, da forma.

rotation?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

textFrame

Para CADA ITEM na coleção: Devolve o objeto de moldura de texto desta forma.

textFrame?: Excel.Interfaces.TextFrameLoadOptions;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

top

Para CADA ITEM na coleção: a distância, em pontos, desde a margem superior da forma até à margem superior da folha de cálculo. Lança uma exceção InvalidArgument quando definida com um valor negativo como entrada.

top?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

type

Para CADA ITEM na coleção: Devolve o tipo desta forma. Veja Excel.ShapeType para obter detalhes.

type?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

visible

Para CADA ITEM na coleção: especifica se a forma está visível.

visible?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

width

Para CADA ITEM na coleção: especifica a largura, em pontos, da forma. Gera uma exceção InvalidArgument quando definida com um valor negativo ou zero como entrada.

width?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]

zOrderPosition

Para CADA ITEM na coleção: Devolve a posição da forma especificada na ordem z, com 0 a representar a parte inferior da pilha de encomendas.

zOrderPosition?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.9 ]