Shape Interface

Esta página é útil?

Algum comentário adicional?

Os comentários serão enviados à Microsoft: quando você pressionar o botão Enviar, seus comentários serão usados para aprimorar os produtos e os serviços da Microsoft. Política de Privacidade.

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 coleção, que representa um subconjunto especificado das formas em um documento ShapeRange (por exemplo, um objeto ShapeRange poderia representar formas um e quatro no documento, ou poderia 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( ), onde é o nome da forma ou o número de índice, para index retornar um objeto index 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( ), onde é o nome da forma ou o número de índice, para retornar um objeto Shape que representa index uma forma dentro da index 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 EndConnectedShape ou.

Retornando uma forma livre recém-criada

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

Retornando uma única forma de dentro de um grupo

Use GroupItems( ), onde é 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 index forma index agrupada.

Retornando um grupo de formas recém-criado

Use o ou método para agrupar um intervalo de formas e Group() retornar um único objeto Regroup() 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 caracteres de texto descritiva (alternativa) de 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 Microsoft Excel aplicativo. Somente leitura.
AutoShapeType	Retorna ou define o tipo de forma do objeto especificado, que deve representar uma AutoForma diferente de uma linha, um desenho de forma Shape livre ou um conector. MsoAutoShapeTypeLeitura/gravação.
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. MsoBlackWhiteModeLeitura/gravação.
BottomRightCell	Retorna um objeto que representa a célula que está sob o canto Range inferior direito do objeto. Somente leitura.
Callout	Retorna um CalloutFormat objeto que contém propriedades de formatação de texto explicativas para a forma especificada. Aplica-se Shape a objetos que representam explicações de linha. Somente leitura.
CanvasItems	Reservado para uso interno.
Chart	Retorna um objeto que representa _Chart o 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 leitura MsoTriState .
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 leitura MsoTriState .
ConnectorFormat	Retorna um ConnectorFormat objeto que contém propriedades de formatação de conector. Aplica-se Shape a objetos que representam conectores. Somente leitura.
ControlFormat	Retorna um ControlFormat objeto que contém Microsoft Excel de controle. 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 leitura XlCreator .
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 leitura XlFormControl .
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 Shape a 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 leitura MsoTriState .
HasDiagramNode	Retorna um valor que indica se um nó de diagrama existe em uma determinada forma ou intervalo de formas. Somente leitura MsoTriState .
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 leitura MsoTriState .
Hyperlink	Retorna um Hyperlink objeto que representa o hiperlink da 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. MsoTriStateLeitura/gravação.
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 Shape a 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 para o objeto especificado. Somente leitura.
ParentGroup	Retorna um Shape objeto que representa a forma pai comum de uma forma filha ou um intervalo de formas filho.
PictureFormat	Retorna um PictureFormat objeto que contém propriedades de formatação de imagem para a forma especificada. Aplica-se Shape a objetos que representam imagens ou objetos OLE. Somente leitura.
Placement	Retorna ou define a maneira como o objeto é anexado às células abaixo dele. XlPlacementLeitura/gravação.
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 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 objeto para uma forma especificada que contém propriedades de formatação de borda suave SoftEdgeFormat 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 T:Microsoft.Office. Interop. Excel. Objetos Shape que representam o WordArt. Somente leitura.
TextFrame	Retorna um TextFrame objeto que contém as propriedades de alinhamento e ancoragem da forma especificada. Somente leitura.
TextFrame2	Retorna um objeto que contém formatação de texto para a forma especificada. Somente leitura.
ThreeD	Retorna um objeto que contém propriedades de formatação de efeito ThreeDFormat 3D 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 objeto que representa a célula que está sob o canto superior Range esquerdo do objeto especificado. Somente leitura.
Type	Retorna ou define o tipo de forma. Somente leitura MsoShapeType .
VerticalFlip	True se a forma especificada for invertida ao redor do eixo vertical. Somente leitura MsoTriState .
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. MsoTriStateLeitura/gravação.
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 desagrupadas 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).