Objeto Shape (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. Você pode posicionar a forma em qualquer lugar da página que contém a âncora.
Há três objetos que representam formas: a coleção Shapes , que representa todas as formas em um documento; o objeto ShapeRange , que representa um subconjunto especificado das formas em um documento (por exemplo, um objeto ShapeRange pode representar formas um e quatro no documento, ou pode 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.
Use Shapes (index), em que index é o nome ou o número do índice, para retornar um único objeto Shape . O exemplo a seguir inverte horizontalmente a forma um do documento ativo.
ActiveDocument.Shapes(1).Flip msoFlipHorizontal
O exemplo a seguir inverte horizontalmente a forma chamada 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.
Use ShapeRange (index), em que index é o nome ou o número do índice, para retornar 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
Use GroupItems (index), em que o índice é 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.
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 retorna o objeto ThreeDFormat , que você usa para criar formas 3D.
Use os métodos PickUp e Apply para transferir a 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.
Use a propriedade Type para especificar o tipo de forma: freeform, AutoShape, objeto OLE, chamada ou imagem vinculada, por exemplo. Use a propriedade AutoShapeType para especificar o tipo de AutoShape: 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. Use o método ConvertToInlineShape e o método ConvertToShape para converter formas de um tipo para outro. Você pode converter somente figuras, objetos OLE e controles ActiveX para formas embutidas.
Métodos
- Apply
- CanvasCropBottom
- CanvasCropLeft
- CanvasCropRight
- CanvasCropTop
- ConvertToInlineShape
- Delete
- Duplicate
- Flip
- IncrementLeft
- IncrementRotation
- IncrementTop
- PickUp
- ScaleHeight
- ScaleWidth
- Select
- SetShapesDefaultProperties
- Ungroup
- ZOrder
Propriedades
- Adjustments
- AlternativeText
- Âncora
- Application
- AutoShapeType
- BackgroundStyle
- Callout
- CanvasItems
- Chart
- Child
- Creator
- Decorative
- Fill
- Glow
- GraphicStyle
- GroupItems
- HasChart
- HasSmartArt
- Height
- HeightRelative
- HorizontalFlip
- Hyperlink
- ID
- LayoutInCell
- Left
- LeftRelative
- Line
- LinkFormat
- LockAnchor
- LockAspectRatio
- Model3D
- Nome
- Nodes
- OLEFormat
- Responsável
- ParentGroup
- PictureFormat
- Reflection
- RelativeHorizontalPosition
- RelativeHorizontalSize
- RelativeVerticalPosition
- RelativeVerticalSize
- Rotation
- Script
- Shadow
- ShapeStyle
- SmartArt
- SoftEdge
- TextEffect
- TextFrame
- TextFrame2
- ThreeD
- Título
- Top
- TopRelative
- Type
- VerticalFlip
- Vertices
- Visible
- Width
- WidthRelative
- WrapFormat
- ZOrderPosition
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.