Compartilhar via

Objeto de forma (Word)

Representa um objeto na camada de desenho, como uma AutoForma, uma forma livre, objeto OLE, controle ActiveX ou imagem. O objeto Shape é membro das formas 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.

Comentários

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. Pode posicionar a forma em qualquer parte da página que contém a âncora.

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

Utilize Formas (índice), em que o índice é o nome ou o número do índice, para devolver um único objeto Forma . O exemplo a seguir inverte horizontalmente a forma um do documento ativo.

ActiveDocument.Shapes(1).Flip msoFlipHorizontal

O exemplo seguinte inverte horizontalmente a forma denominada Retângulo 1 no documento ativo.

ActiveDocument.Shapes("Rectangle 1").Flip msoFlipHorizontal

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

Utilize ShapeRange (índice), em que o índice é o nome ou o número do índice, para devolver um objeto Shape que representa uma forma dentro de uma seleção. O exemplo a seguir define o preenchimento da primeira forma na seleção, pressupondo-se de que a seleção contenha pelo menos uma forma.

Selection.ShapeRange(1).Fill.ForeColor.RGB = RGB(255, 0, 0)

O exemplo a seguir define o preenchimento de todas as formas da seleção, supondo que a seleção contenha pelo menos uma forma.

Selection.ShapeRange.Fill.ForeColor.RGB = RGB(255, 0, 0)

Para adicionar um objeto Shape à coleção de formas do documento especificado e retornar um objeto Shape que representa a forma recém-criada, use um dos seguintes métodos da coleção Shapes: AddCallout, AddCurve, AddLabel, AddLine, AddOleControl, AddOleObject, AddPolyline, AddShape, AddTextbox, AddTextEffect ou BuildFreeForm. O exemplo a seguir adiciona um retângulo ao documento ativo.

ActiveDocument.Shapes.AddShape msoShapeRectangle, 50, 50, 100, 200

Utilize GroupItems (índice), em que índice é o nome da forma ou o número de índice dentro do grupo, para devolver um objeto Forma que representa uma única forma numa forma agrupada.

Usar o grupo de ou Reagrupar método 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.

Cada objeto Shape é 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 visualizar a própria âncora definindo o ShowObjectAnchors propriedade como True. Da forma superior e à esquerda as propriedades determinam suas posições horizontal e vertical. Da forma RelativeHorizontalPosition e RelativeVerticalPosition as propriedades 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 o LockAnchor propriedade para a forma estiver definida como True, você não poderá arrastar a âncora de sua posição na página.

Use a propriedade Fill para retornar o FillFormat objeto que contém todas as propriedades e métodos para formatar o preenchimento de uma forma fechada.

A propriedade Shadow retorna o ShadowFormat objeto, que você usa para formatar uma sombra.

Use a propriedade da linha para retornar o LineFormat objeto que contém propriedades e métodos para formatação de linhas e setas.

A propriedade TextEffect retorna TextEffectFormat objeto que você usa para Formatar WordArt.

A propriedade Callout retorna o CalloutFormat objeto, que você usa para formatar textos explicativos de linha.

A propriedade WrapFormat retorna o WrapFormat objeto você usa para definir a disposição do texto ao redor das formas.

A propriedade ThreeD devolve o objeto ThreeDFormat , que utiliza para criar formas 3D.

Utilize os métodos PickUp e Apply para transferir formatação de uma forma para outra.

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

Utilize a propriedade Tipo para especificar o tipo de forma: forma livre, Forma Automática, objeto OLE, nota de aviso ou imagem ligada, por exemplo. Utilize a propriedade AutoShapeType para especificar o tipo de forma automática: oval, retângulo ou balão, por exemplo.

Use a largura e a Altura propriedades para especificar o tamanho da forma.

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

Objetos Shape ficam vinculados a um intervalo de texto, mas são flutuante independente e podem ser posicionados em qualquer lugar na página. InlineShape objetos são tratados como caracteres e são posicionados como caracteres dentro de uma linha de texto. Utilize o método ConvertToInlineShape e o método ConvertToShape para converter formas de um tipo para o outro. Você pode converter somente figuras, objetos OLE e controles ActiveX para formas embutidas.

Métodos

Propriedades

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.

  • Last updated on