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

Assembly:

Microsoft.Office.Interop.Word.dll

Representa um objeto na camada de desenho, como uma AutoForma, uma forma livre, objeto OLE, controle ActiveX ou imagem.

public interface class Shape

[System.Runtime.InteropServices.Guid("000209A0-0000-0000-C000-000000000046")]
public interface Shape

type Shape = interface

Public Interface Shape

Atributos

GuidAttribute

Comentários

O Shape objeto é um membro da Shapes coleção, que inclui todas as formas no texto principal de um documento ou em todos os cabeçalhos e rodapés de um documento.

Uma forma está sempre anexada a um intervalo de ancoragem e pode ser posicionada em qualquer local da página que contém a âncora. Você pode posicionar a forma em qualquer lugar na página que contém a âncora.

Há três objetos que representam formas: a Shapes coleção, 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 ShapeRange objeto pode representar as formas um e quatro no documento ou pode representar todas as formas selecionadas no documento); o Shape objeto, 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 ShapeRange coleção.

Use Shapes( index ), onde index é o nome ou o número de índice, para retornar um único Shape objeto.

Cada forma é atribuída um nome padrão quando ele é criado. Por exemplo, se você adicionar três formas diferentes a um documento, elas podem ser nomeadas "Rectangle 2", "TextBox 3" e "Oval 4". Para dar um nome mais significativo a uma forma, defina a Name propriedade.

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

Para adicionar um Shape objeto à coleção de formas para o documento especificado e retornar um Shape objeto que representa a forma recém-criada, use um dos seguintes métodos da coleção:,,,,,,, Shapes AddCallout(MsoCalloutType, Single, Single, Single, Single, Object) AddCurve(Object, Object) AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object) AddLine(Single, Single, Single, Single, Object) AddOLEControl(Object, Object, Object, Object, Object, Object) AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) AddPolyline(Object, Object) AddShape(Int32, Single, Single, Single, Single, Object) , AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object) , AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object) ou BuildFreeform(MsoEditingType, Single, Single) .

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

Use o Group() Regroup() método ou para agrupar um intervalo de formas e retornar um único Shape objeto 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.

Cada Shape objeto é ancorado a um intervalo de texto. Uma forma é ancorada ao início do primeiro parágrafo que contém o intervalo de ancoragem. A forma sempre permanecerá na mesma página que sua âncora.

Você pode exibir a própria ancoragem definindo a ShowObjectAnchors propriedade como true. As Top Propriedades e da forma Left determinam suas posições verticais e horizontais. As RelativeHorizontalPosition Propriedades e a forma RelativeVerticalPosition determinam se a posição é medida a partir do parágrafo de ancoragem, a coluna que contém o parágrafo de ancoragem, a margem ou a borda da página.

Se a LockAnchor propriedade da forma for definida como true, você não poderá arrastar a âncora de sua posição na página.

Use a Fill propriedade para retornar o FillFormat objeto, que contém todas as propriedades e métodos para formatar o preenchimento de uma forma fechada. A Shadow propriedade retorna o ShadowFormat objeto, que você usa para formatar uma sombra. Use a Line propriedade para retornar o LineFormat objeto, que contém propriedades e métodos para formatação de linhas e setas. A TextEffect propriedade retorna o TextEffectFormat objeto, que você usa para formatar WordArt. A Callout propriedade retorna o CalloutFormat objeto, que você usa para Formatar textos explicativos de linha. A WrapFormat propriedade retorna o WrapFormat objeto, que você usa para definir como o texto será disposto ao redor das formas. A ThreeD propriedade retorna o ThreeDFormat objeto, que você usa para criar formas 3D. Você pode usar os PickUp() Apply() métodos e para transferir a formatação de uma forma para outra.

Use o SetShapesDefaultProperties() método para um Shape objeto para definir a formatação da forma padrão para o documento. As novas formas herdam muitos dos atributos da forma padrão.

Use a Type propriedade para especificar o tipo de forma: forma livre, AutoForma, objeto OLE, texto explicativo ou imagem vinculada, por exemplo. Use a AutoShapeType propriedade para especificar o tipo de AutoForma: oval, retângulo ou balão, por exemplo.

Use as Width Height Propriedades e para especificar o tamanho da forma.

A TextFrame propriedade retorna o TextFrame objeto, que contém todas as propriedades e métodos para anexar texto a formas e vincular o texto entre quadros de texto.

Shapeos objetos são ancorados a um intervalo de texto, mas estão livres para flutuar e podem ser posicionados em qualquer lugar na página. InlineShapeos objetos são tratados como caracteres e são posicionados como caracteres dentro de uma linha de texto. Você pode usar o ConvertToInlineShape() método e o ConvertToShape() método para converter formas de um tipo para outro. Você pode converter somente figuras, objetos OLE e controles ActiveX para formas embutidas.

Propriedades

Adjustments	Retorna um Adjustments objeto que contém valores de ajuste para todos os ajustes no Shape objeto especificado que representa uma AutoForma ou WordArt.
AlternativeText	Retorna ou define o texto alternativo associado a uma forma em uma página da Web.
Anchor	Retorna um Range objeto que representa o intervalo de ancoragem para a forma especificada.
AnchorID
Application	Retorna um Application objeto que representa o aplicativo Microsoft Word.
AutoShapeType	Retorna ou define o tipo de forma para o Shape objeto especificado, que deve representar uma AutoForma que não seja uma linha ou um desenho de forma livre.
BackgroundStyle	Obtém ou define o estilo de plano de fundo da forma especificada.
Callout	Retorna um CalloutFormat objeto que contém propriedades de formatação de texto explicativo para a forma especificada.
CanvasItems	Retorna um CanvasShapes objeto que representa uma coleção de formas em uma tela de desenho.
Chart	Retorna um Chart objeto que representa um gráfico dentro da coleção de formas em um documento. Somente leitura.
Child	Determina se a forma é uma forma filha.
ConnectionSiteCount	Reservado para uso interno.
Connector	Reservado para uso interno.
ConnectorFormat	Reservado para uso interno.
Creator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
Diagram	Retorna um Diagram objeto ao qual pertence um nó de diagrama.
DiagramNode	Retorna um DiagramNode objeto que representa um nó em um diagrama.
EditID
Fill	Retorna um FillFormat objeto que contém propriedades de formatação de preenchimento para a forma especificada.
Glow	Retorna um GlowFormat objeto que representa a formatação de brilho de uma forma. Somente leitura.
GroupItems	Retorna um GroupShapes objeto que representa as formas individuais no grupo especificado.
HasChart	True se a forma especificada tem um gráfico. Somente leitura.
HasDiagram	Determina se uma forma é um diagrama.
HasDiagramNode	Determina se uma forma é um nó de diagrama.
HasSmartArt	Obtém true se houver um diagrama SmartArt presente na forma.
Height	Retorna ou define a altura da forma especificada em pontos.
HeightRelative	Retorna ou define um valor único que representa a porcentagem da altura relativa de uma forma. Leitura/gravação.
HorizontalFlip	Indica que uma forma foi virada horizontalmente.
Hyperlink	Retorna um Hyperlink objeto que representa o hiperlink associado à forma especificada.
ID	Retorna o tipo do objeto especificado.
LayoutInCell	Retorna um inteiro que indica se uma forma em uma tabela é exibida dentro da tabela ou fora da tabela.
Left	Retorna ou define um valor único que representa a posição horizontal, medida em pontos, da forma especificada ou intervalo de formas.
LeftRelative	Retorna ou define um valor único que representa a posição relativa à esquerda de uma forma. Leitura/gravação.
Line	Retorna um LineFormat objeto que contém as propriedades de formatação de linha para a forma especificada.
LinkFormat	Retorna um LinkFormat objeto que representa as opções de vínculo da forma especificada que está vinculada a um arquivo.
LockAnchor	Determina se a Shape âncora do objeto especificado está bloqueada para o intervalo de ancoragem.
LockAspectRatio	Determina se você pode alterar a altura e a largura da forma, independentemente uma da outra, ao redimensioná-la ou se ela mantiver as proporções originais.
Name	Retorna ou define o nome do objeto especificado.
Nodes	Retorna uma ShapeNodes coleção que representa a descrição geométrica da forma especificada.
OLEFormat	Retorna um OLEFormat objeto que representa as características OLE (diferentes de vinculação) para a forma especificada.
Parent	Retorna um objeto que representa o objeto pai do objeto especificado.
ParentGroup	Retorna um Shape objeto que representa a forma pai comum de uma forma filha.
PictureFormat	Retorna um PictureFormat objeto que contém as propriedades de formatação da imagem para o objeto especificado.
Reflection	Retorna um ReflectionFormat objeto que representa a formatação de reflexo de uma forma. Somente leitura.
RelativeHorizontalPosition	Especifica o que a posição horizontal de uma forma é relativa.
RelativeHorizontalSize	Retorna ou define uma WdRelativeHorizontalSize constante que representa o objeto ao qual um intervalo de formas é relativo. Leitura/gravação.
RelativeVerticalPosition	Especifica a que a posição vertical de uma forma é relativa.
RelativeVerticalSize	Retorna ou define uma WdRelativeVerticalSize constante que representa o tamanho vertical relativo de uma forma. Leitura/gravação.
Rotation	Retorna ou define o número de graus em que a forma especificada é girada ao redor do eixo z.
RTF	Reservado para uso interno.
Script	Retorna um Script objeto que representa um bloco de script ou código na página da Web especificada.
Shadow	Retorna um ShadowFormat objeto que representa a formatação de sombra para a forma especificada.
ShapeStyle	Obtém ou define o estilo de forma para a forma especificada.
SmartArt	Obtém um SmartArt objeto que oferece uma maneira de trabalhar com o SmartArt associado à forma especificada.
SoftEdge	Retorna um SoftEdgeFormat objeto que representa a formatação de borda suave para uma forma. Somente leitura.
TextEffect	Retorna um TextEffectFormat objeto que contém propriedades de formatação de efeito de texto para a forma especificada.
TextFrame	Retorna um TextFrame objeto que contém o texto da forma especificada.
TextFrame2	Retorna um TextFrame2 objeto que contém o texto da forma especificada. Somente leitura.
ThreeD	Retorna um ThreeDFormat objeto que contém as propriedades de formatação do efeito tridimensional da forma especificada.
Title	Obtém ou define uma cadeia de caracteres que contém um título para a forma especificada.
Top	Retorna ou define a posição vertical da forma especificada, em pontos.
TopRelative	Retorna ou define um valor único que representa a posição relativa de superior de uma forma. Leitura/gravação.
Type	Retorna o tipo de forma.
VerticalFlip	Determina se a forma especificada está invertida em torno do eixo vertical.
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.
Visible	Determina se o objeto especificado ou a formatação aplicada a ele está visível.
Width	Retorna ou define a largura do objeto especificado, em pontos.
WidthRelative	Retorna ou define um Single que representa a largura relativa de uma forma. Leitura/gravação.
WrapFormat	Retorna um WrapFormat objeto que contém as propriedades de quebra de texto ao redor da forma especificada.
ZOrderPosition	Retorna a posição da forma especificada, de acordo com a ordem z.

Métodos

Activate()	Ativa o objeto especificado.
Apply()	Aplica-se à formatação de forma especificada que foi copiada usando o PickUp() método.
CanvasCropBottom(Single)	Corta uma porcentagem da altura de uma tela de desenho começando pela parte inferior da tela.
CanvasCropLeft(Single)	Corta uma porcentagem da largura de uma tela de desenho começando pela parte esquerda da tela.
CanvasCropRight(Single)	Corta uma porcentagem da largura de uma tela de desenho começando pela direita da tela.
CanvasCropTop(Single)	Corta uma porcentagem da altura de uma tela de desenho começando pela parte superior da tela.
ConvertToFrame()	Converte a forma especificada em um quadro.
ConvertToInlineShape()	Converte a forma especificada na camada de desenho de um documento em uma forma embutida na camada de texto.
Delete()	Exclui o objeto especificado.
Duplicate()	Cria uma duplicata do objeto especificado Shape , adiciona o novo intervalo de formas à Shapes coleção em um deslocamento padrão das formas originais e retorna o novo objeto Shape .
Flip(MsoFlipCmd)	Inclina uma forma no sentido 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.
IncrementTop(Single)	Move a forma especificada verticalmente pelo número especificado de pontos.
PickUp()	Copia a formatação da forma especificada.
RerouteConnections()	Reservado para uso interno.
ScaleHeight(Single, MsoTriState, MsoScaleFrom)	Dimensiona a altura da forma por um fator especificado.
ScaleWidth(Single, MsoTriState, MsoScaleFrom)	Dimensiona a largura da forma por um fator especificado.
Select(Object)	Seleciona o objeto especificado.
SetShapesDefaultProperties()	Aplica a formatação da forma especificada a uma forma padrão para esse documento. As novas formas herdam muitos dos atributos da forma padrão.
Ungroup()	Desagrupa todas as formas agrupadas na forma especificada.
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).