Shape Interface

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 main história 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 da 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 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ê quiser trabalhar com várias formas ao mesmo tempo ou com formas dentro da seleção, use uma ShapeRange coleção.

Use Shapes(index), em que index é o nome ou o número do í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 a uma forma um nome mais significativo, defina a Name propriedade.

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

Para adicionar um Shape objeto à coleção de formas do documento especificado e retornar um Shape objeto que representa a forma recém-criada, use um dos seguintes métodos da Shapes coleção: 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), 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.

Use o Group() método ou Regroup() 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 em 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 âncora definindo a ShowObjectAnchors propriedade como True. As propriedades e Left da Top forma determinam suas posições verticais e horizontais. As propriedades e RelativeVerticalPosition da RelativeHorizontalPosition forma determinam se a posição é medida do parágrafo de ancoragem, da 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 formatar linhas e setas. A TextEffect propriedade retorna o TextEffectFormat objeto, que você usa para formatar o WordArt. A Callout propriedade retorna o CalloutFormat objeto, que você usa para formatar callouts de linha. A WrapFormat propriedade retorna o WrapFormat objeto, que você usa para definir como o texto envolve formas. A ThreeD propriedade retorna o ThreeDFormat objeto, que você usa para criar formas 3D. Você pode usar os PickUp() métodos e Apply() para transferir a formatação de uma forma para outra.

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

Use a Type propriedade para especificar o tipo de forma: freeform, AutoShape, objeto OLE, chamada ou imagem vinculada, por exemplo. Use a AutoShapeType propriedade para especificar o tipo de AutoShape: oval, retângulo ou balão, por exemplo.

Use as Width propriedades e Height 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.

Shape os objetos são ancorados em um intervalo de texto, mas são livremente flutuantes e podem ser posicionados em qualquer lugar da página. InlineShape os 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 objeto especificado Shape que representa um AutoShape 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	Representa um objeto na camada de desenho, como uma AutoForma, uma forma livre, objeto OLE, controle ActiveX ou imagem.
Application	Retorna um Application objeto que representa o aplicativo microsoft Word.
AutoShapeType	Retorna ou define o tipo de forma para o objeto especificado Shape , que deve representar um AutoShape diferente de um desenho de linha ou de forma livre.
BackgroundStyle	Obtém ou define o estilo de segundo plano da forma especificada.
Callout	Retorna um CalloutFormat objeto que contém propriedades de formatação de callout 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 filho.
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	Representa um objeto na camada de desenho, como uma AutoForma, uma forma livre, objeto OLE, controle ActiveX ou imagem.
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 para 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 represente 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 representa 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 de esquerda de uma forma. Leitura/gravação.
Line	Retorna um LineFormat objeto que contém propriedades de formatação de linha para a forma especificada.
LinkFormat	Retorna um LinkFormat objeto que representa as opções de link da forma especificada vinculada a um arquivo.
LockAnchor	Determina se a âncora do objeto especificado Shape está bloqueada no intervalo de ancoragem.
LockAspectRatio	Determina se você pode alterar a altura e a largura da forma independentemente uma da outra quando você redimensioná-la ou se ela mantém suas 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 (diferente da 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 filho.
PictureFormat	Retorna um PictureFormat objeto que contém propriedades de formatação de imagem para o objeto especificado.
Reflection	Retorna um ReflectionFormat objeto que representa a formatação de reflexão para uma forma. Somente leitura.
RelativeHorizontalPosition	Especifica qual é 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 qual é 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 que à 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 fornece uma maneira de trabalhar com o SmartArt associado à forma especificada.
SoftEdge	Retorna um SoftEdgeFormat objeto que representa a formatação de borda macia 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 para a forma especificada.
TextFrame2	Retorna um TextFrame2 objeto que contém o texto para a forma especificada. Somente leitura.
ThreeD	Retorna um ThreeDFormat objeto que contém propriedades de formatação do efeito tridimensional para a 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 é invertida ao redor 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ão visíveis.
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 para encapsular texto em torno 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).