Shape Interface

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Representa um objeto na camada de desenho, como uma AutoForma, uma forma livre, um objeto OLE ou uma figura. O objeto Shape é um membro da Shapes coleção. A coleção Shapes contém todas as formas em um slide.

public interface class Shape

[System.Runtime.InteropServices.Guid("00024439-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface Shape

Public Interface Shape

Atributos

GuidAttribute InterfaceTypeAttribute

Comentários

Há três objetos que representam formas: a coleção Shapes , que representa todas as formas em um documento; a ShapeRange coleção, que representa um subconjunto especificado das formas em um documento (por exemplo, um objeto ShapeRange pode representar formas um e quatro no documento, ou pode representar todas as formas selecionadas no documento); e o objeto Shape , que representa uma única forma em um documento. Se você deseja trabalhar com várias formas ao mesmo tempo ou com formas dentro da seleção, use uma coleção ShapeRange.

Esta seção descreve como:

• Retornar uma forma existente.
• Retornar uma forma dentro da seleção.
• Retornar as formas anexadas às extremidades de um conector.
• Retornar uma forma livre recém-criada.
• Retornar uma única forma de dentro de um grupo.
• Retornar um grupo recém-criado de formas.

Retornando uma forma existente

Use Shapes(index), em que index é o nome da forma ou o número do índice, para retornar um objeto Shape que representa uma forma.

A cada forma é atribuído um nome padrão quando você adiciona a coleção Shapes. Para dar à forma um nome mais significativo, use a Name propriedade.

Retornando uma forma dentro da seleção

Use Selection.ShapeRange(index), onde index é o nome da forma ou o número do índice, para retornar um objeto Shape que representa uma forma dentro da seleção.

Retornando as formas anexadas às extremidades de um conector

Para retornar um objeto Shape que representa uma das formas anexadas por um conector, use a BeginConnectedShape propriedade ou EndConnectedShape .

Retornando uma forma livre recém-criada

Use os BuildFreeform(MsoEditingType, Single, Single) métodos e AddNodes(MsoSegmentType, MsoEditingType, Single, Single, Object, Object, Object, Object) para definir a geometria de uma nova forma livre e use o ConvertToShape() método para criar a forma livre e retornar o objeto Shape que o representa.

Retornando uma única forma de dentro de um grupo

Use GroupItems(index), em que index é o nome da forma ou o número de índice dentro do grupo, para retornar um objeto Shape que representa uma única forma em uma forma agrupada.

Retornando um grupo de formas recém-criado

Use o Group() método ou Regroup() para agrupar um intervalo de formas e retornar um único objeto Shape que representa o grupo recém-formado. Após um grupo ter sido formado, você pode trabalhar com o grupo da mesma maneira que você trabalha com qualquer outra forma.

Propriedades

Adjustments	Retorna um Adjustments objeto que contém valores de ajuste para todos os ajustes na forma especificada. Somente leitura.
AlternativeText	Retorna ou define a cadeia de texto descritiva (alternativa) para um Shape objeto quando o objeto é salvo em uma página da Web. String de leitura/gravação.
Application	Retorna um Application objeto que representa o aplicativo Microsoft Excel. Somente leitura.
AutoShapeType	Retorna ou define o tipo de forma para o objeto especificado Shape , que deve representar um AutoShape diferente de uma linha, desenho de forma livre ou conector. Leitura/gravação MsoAutoShapeType.
BackgroundStyle	Retorna ou define o estilo do segundo plano. Leitura/gravação.
BlackWhiteMode	Retorna ou define um valor que indica a maneira pela qual a forma especificada aparecerá quando a apresentação for exibida em preto e branco. Leitura/gravação MsoBlackWhiteMode.
BottomRightCell	Retorna um Range objeto que representa a célula que está sob o canto inferior direito do objeto. Somente leitura.
Callout	Retorna um CalloutFormat objeto que contém propriedades de formatação de callout para a forma especificada. Aplica-se a Shape objetos que representam chamadas de linha. Somente leitura.
CanvasItems	Reservado para uso interno.
Chart	Retorna um objeto que representa o _Chart contido no Shape. Somente leitura.
Child	Retorna msoTrue se a forma especificada for uma forma filha ou se todas as formas em um intervalo de formas forem formas filhas de um mesmo pai. Somente MsoTriStateleitura .
ConnectionSiteCount	Retorna o número de locais de conexão na forma especificada. Integer somente leitura.
Connector	True se a forma especificada for um conector. Somente MsoTriStateleitura .
ConnectorFormat	Retorna um ConnectorFormat objeto que contém propriedades de formatação do conector. Aplica-se a Shape objetos que representam conectores. Somente leitura.
ControlFormat	Retorna um ControlFormat objeto que contém propriedades de controle do Microsoft Excel. Somente leitura.
Creator	Retorna um inteiro de 32 bits que indica o aplicativo no qual esse objeto foi criado. Se o objeto foi criado no Microsoft Excel, essa propriedade retornará a sequência XCEL, que é equivalente ao número hexadecimal 5843454C. Somente XlCreatorleitura .
Diagram	Retorna um Diagram objeto que representa um diagrama.
DiagramNode	Retorna um DiagramNode objeto que representa um nó em um diagrama.
DrawingObject	Reservado para uso interno.
Fill	Retorna um FillFormat objeto que contém propriedades de formatação de preenchimento para o gráfico ou forma especificado. Somente leitura.
FormControlType	Retorna o tipo de controle do Microsoft Excel. Somente XlFormControlleitura .
Glow	Retorna um objeto para uma forma especificada que contém propriedades de formatação de brilho para essa forma. Somente leitura.
GroupItems	Retorna um GroupShapes objeto que representa as formas individuais no grupo especificado. Use o Item(Object) método do objeto GroupShapes para retornar uma única forma do grupo. Aplica-se a Shape objetos que representam formas agrupadas. Somente leitura.
HasChart	Retorna informações sobre se um Shape contém um gráfico. Somente leitura.
HasDiagram	Retorna se uma forma ou intervalo de formas contém um diagrama. Somente MsoTriStateleitura .
HasDiagramNode	Retorna um valor que indica se existe um nó de diagrama em uma determinada forma ou intervalo de formas. Somente MsoTriStateleitura .
HasSmartArt	Obtém se há um diagrama SmartArt presente na forma especificada.
Height	A altura do objeto. Leitura/gravação único.
HorizontalFlip	True se a forma especificada for invertida ao redor do eixo horizontal. Somente MsoTriStateleitura .
Hyperlink	Retorna um Hyperlink objeto que representa o hiperlink para a forma.
ID	Retorna o tipo do objeto especificado. Integer somente leitura.
Left	A distância da borda esquerda do objeto até a borda esquerda da coluna A (em uma planilha) ou a borda esquerda da área do gráfico (em um gráfico). Leitura/gravação único.
Line	Retorna um LineFormat objeto que contém propriedades de formatação de linha para a forma especificada. Somente leitura.
LinkFormat	Retorna um LinkFormat objeto que contém propriedades de objeto OLE vinculadas. Somente leitura.
LockAspectRatio	True se a forma especificada mantiver suas proporções originais após o redimensionamento. False se você puder alterar a altura e a largura da forma, separadamente, ao redimensioná-la. Leitura/gravação MsoTriState.
Locked	True se o objeto estiver bloqueado, False se o objeto puder ser modificado quando a planilha estiver protegida. Boolean de leitura/gravação.
Name	Retorna ou define o nome do objeto. String de leitura/gravação.
Nodes	Retorna uma ShapeNodes coleção que representa a descrição geométrica da forma especificada. Aplica-se a Shape objetos que representam desenhos de forma livre.
OLEFormat	Retorna um OLEFormat objeto que contém propriedades de objeto OLE. Somente leitura.
OnAction	Retorna ou define o nome de uma macro executada quando o objeto especificado é clicado. String de leitura/gravação.
Parent	Retorna o objeto pai do objeto especificado. Somente leitura.
ParentGroup	Retorna um Shape objeto que representa a forma comum pai de uma forma filho ou uma variedade de formas filho.
PictureFormat	Retorna um PictureFormat objeto que contém propriedades de formatação de imagem para a forma especificada. Aplica-se a Shape objetos que representam imagens ou objetos OLE. Somente leitura.
Placement	Retorna ou define a maneira como o objeto é anexado às células abaixo dele. Leitura/gravação XlPlacement.
Reflection	Retorna um objeto que contém propriedades de formatação de reflexão para a forma. Somente leitura.
Rotation	Retorna ou define a rotação da forma em graus. Leitura/gravação único.
Script	Retorna o objeto Script, que representa um bloco de script ou código na página da Web especificada. Se a página não contiver nenhum script, nada será retornado.
Shadow	True se o objeto tiver uma sombra. Boolean de leitura/gravação.
ShapeStyle	Retorna ou define um MsoShapeStyleIndex que representa o estilo de forma da forma. Leitura/gravação.
SmartArt	Obtém um objeto que representa o SmartArt associado à forma.
SoftEdge	Retorna um SoftEdgeFormat objeto para uma forma especificada que contém propriedades de formatação de borda macia para a forma. Somente leitura.
TextEffect	Retorna um TextEffectFormat objeto que contém propriedades de formatação de efeito de texto para a forma especificada. Aplica-se a objetos T:Microsoft.Office.Interop.Excel.Shape que representam o WordArt. Somente leitura.
TextFrame	Retorna um TextFrame objeto que contém as propriedades de alinhamento e ancoragem para a forma especificada. Somente leitura.
TextFrame2	Retorna um objeto que contém formatação de texto para a forma especificada. Somente leitura.
ThreeD	Retorna um ThreeDFormat objeto que contém propriedades de formatação de efeito 3D – efeito para a forma especificada. Somente leitura.
Title	Obtém ou define o título do texto alternativo associado à forma especificada.
Top	A distância da borda superior da forma mais superior no intervalo de formas até a borda superior da planilha. Leitura/gravação único.
TopLeftCell	Retorna um Range objeto que representa a célula que está sob o canto superior esquerdo do objeto especificado. Somente leitura.
Type	Retorna ou define o tipo de forma. Somente MsoShapeTypeleitura .
VerticalFlip	True se a forma especificada for invertida ao redor do eixo vertical. Somente MsoTriStateleitura .
Vertices	Retorna as coordenadas dos vértices (e pontos de controle para curvas Bézier) do desenho de forma livre especificado como uma série de pares de coordenadas. Somente leitura objeto.
Visible	Determina se o objeto será visível. Leitura/gravação MsoTriState.
Width	A largura do objeto. Leitura/gravação único.
ZOrderPosition	Retorna a posição da forma especificada, de acordo com a ordem z. Integer somente leitura.

Métodos

Apply()	Aplica-se à formatação de forma especificada que foi copiada usando o PickUp() método.
CanvasCropBottom(Single)	Reservado para uso interno.
CanvasCropLeft(Single)	Reservado para uso interno.
CanvasCropRight(Single)	Reservado para uso interno.
CanvasCropTop(Single)	Reservado para uso interno.
Copy()	Copia o objeto para a Área de Transferência.
CopyPicture(Object, Object)	Copia o objeto selecionado para a Área de Transferência como uma imagem.
Cut()	Recorta o objeto para a Área de Transferência ou o cola em um local especificado.
Delete()	Exclui o objeto.
Duplicate()	Duplica o objeto e retorna uma referência para a nova cópia.
Flip(MsoFlipCmd)	Inverte a forma especificada ao redor de seu eixo horizontal ou vertical.
IncrementLeft(Single)	Move horizontalmente a forma especificada pelo número especificado de pontos.
IncrementRotation(Single)	Altera a rotação da forma especificada ao redor do eixo z pelo número especificado de graus. Use a Rotation propriedade para definir a rotação absoluta da forma.
IncrementTop(Single)	Move a forma especificada verticalmente pelo número especificado de pontos.
PickUp()	Copia a formatação da forma especificada. Use o Apply() método para aplicar a formatação copiada a outra forma.
RerouteConnections()	Redireciona os conectores para que eles tomem o caminho mais curto possível entre as formas que conectam.
ScaleHeight(Single, MsoTriState, Object)	Dimensiona a altura da forma por um fator especificado.
ScaleWidth(Single, MsoTriState, Object)	Dimensiona a largura da forma por um fator especificado.
Select(Object)	Seleciona o objeto.
SetShapesDefaultProperties()	Define a formatação da forma especificada como padrão para a mesma.
Ungroup()	Desagrupa quaisquer formas agrupadas na forma especificada ou intervalo de formas. Desmonta imagens e objetos OLE dentro da forma especificada. Retorna as formas não agrupadas como um único ShapeRange objeto.
ZOrder(MsoZOrderCmd)	Move a forma especificada para a frente ou para trás das outras formas na coleção (isto é, altera a posição da forma na ordem z).