Compartilhar via


Shape Interface

Definição

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

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

Aplica-se a