Classe Shape - um objeto na camada de desenho (Word VBA)

A classe Shape 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.

As classes Document, FreeformBuilder, Hyperlink, InlineShape e Window. dão acesso à classe Shape


Dim shp as Shape
Set shp = ActiveDocument.Background

For Each

Aqui está um exemplo de processamento dos itens Shape em uma coleção. 


Dim shpCanvasItem As Shape
For Each shpCanvasItem In CanvasItems
	
Next shpCanvasItem

Métodos

Apply - Aplica a formatação da forma especificada que foi copiada usando o método PickUp.

CanvasCropBottom - Corta uma porcentagem da altura de uma tela de desenho começando pela parte inferior da tela.

CanvasCropLeft - Corta uma porcentagem da largura de uma tela de desenho começando pela parte esquerda da tela.

CanvasCropRight - Corta uma porcentagem da largura de uma tela de desenho começando pela direita da tela.

CanvasCropTop - Corta uma porcentagem da altura de uma tela de desenho começando pela parte superior da tela.

ConvertToInlineShape - Converte a forma especificada na camada de desenho de um documento em uma forma embutida na camada de texto. É possível converter somente formas que representam imagens, objetos OLE ou controles ActiveX. Esse método retorna um objeto InlineShape que representa a imagem ou o objeto OLE.

Delete - Exclui o nó de forma especificado.

Duplicate - Cria uma duplicata do objeto Shape especificado, adiciona a nova forma à coleção Shapes em um deslocamento padrão das formas originais e retorna o novo objeto Shape .

Flip - Inclina uma forma no sentido horizontal ou vertical.

IncrementLeft - Move horizontalmente a forma especificada pelo número especificado de pontos.

IncrementRotation - Altera a rotação da forma especificada ao redor do eixo z pelo número especificado de graus.

IncrementTop - Move a forma especificada verticalmente pelo número especificado de pontos.

PickUp - Copia a formatação da forma especificada.

ScaleHeight - Dimensiona a altura da forma por um fator especificado.

ScaleWidth - Dimensiona a largura da forma por um fator especificado.

Select - Seleciona a forma especificada.

SetShapesDefaultProperties - Aplica a formatação da forma padrão de um documento a uma forma especificada.

Ungroup - Desagrupa todas as formas agrupadas na forma especificada.

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

Propriedades

Adjustments Retorna um objeto Adjustments que contém valores de ajuste para todos os ajustes no objeto Shape especificado que representa uma AutoForma ou WordArt. Somente leitura.

AlternativeText Retorna ou define o texto alternativo associado a uma forma em uma página da Web. String de leitura/gravação.

Anchor Retorna um objeto Range que representa o intervalo de ancoragem para a forma especificada ou intervalo de formas. Somente leitura.

AutoShapeType Retorna ou define o tipo de forma para o objeto Shape especificado, que deve representar uma AutoForma que não seja uma linha ou um desenho de forma livre. MsoAutoShapeType de leitura/gravação.

BackgroundStyle Define ou retorna o estilo de plano de fundo da forma especificada. MsoBackgroundStyleIndex de leitura/gravação.

Callout Retorna um objeto CalloutFormat que contém as propriedades de formatação de texto explicativo para a forma especificada. Somente leitura.

CanvasItems Retorna um objeto CanvasShapes que representa uma coleção de formas em uma tela de desenho.

Chart Retorna um objeto Chart que representa um gráfico dentro da coleção de formas em um documento. Somente leitura.

Child True se a forma for uma forma filha ou se todas as formas em um intervalo de formas são formas filhas do mesmo pai. Somente leitura MsoTriState.

Decorative Define ou retorna o sinalizador decorativo para o objeto especificado. Leitura/gravação.

Fill Retorna um objeto FillFormat que contém as propriedades de formatação de preenchimento para a forma especificada. Somente leitura.

Glow Retorna um objeto GlowFormat que representa a formatação de brilho de uma forma. Somente leitura.

GraphicStyle Retorna ou define uma constante MsoGraphicStyleIndex que representa o estilo de um gráfico SVG. Leitura/gravação.

GroupItems Retorna um objeto GroupShapes que representa as formas individuais no grupo especificado. Somente leitura.

HasChart True se a forma especificada tem um gráfico. Somente leitura.

HasSmartArt Retorna true se houver um diagrama SmartArt presente na forma. Somente leitura.

Height Retorna ou define a altura em pontos da forma especificada. Leitura/gravação única.

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. MsoTriStatesomente leitura.

Hyperlink Retorna um objeto Hyperlink que representa o hiperlink associado a um objeto Shape . Somente leitura.

ID Retorna o tipo de identificação para a forma especificada. Long somente leitura.

LayoutInCell Retorna um Long que indica se uma forma em uma tabela é exibida dentro 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. Também pode ser qualquer constante WdShapePosition válida. Leitura/gravação.

LeftRelative Retorna ou define um valor único que representa a posição relativa à esquerda de uma forma. Leitura/gravação.

Line Retorna um objeto LineFormat que contém as propriedades de formatação de linha para a forma especificada. Somente leitura.

LinkFormat Retorna um objeto LinkFormat que representa as opções de vínculo de uma forma que está vinculada a um arquivo. / Somente leitura.

LockAnchor True se a âncora de um objeto Shape estiver fixa no intervalo de ancoragem. Long de leitura/gravação.

LockAspectRatio MsoTrue se a forma especificada retém suas proporções originais quando você a redimensiona. MsoFalse se você pode alterar a altura e largura da forma independentemente uma da outra, ao redimensioná-la. MsoTriState para leitura/gravação.

Model3D Retorna um objeto Model3DFormat que contém as propriedades Model3D. Somente leitura.

Name Retorna ou define o nome do objeto especificado. String de leitura/gravação.

Nodes Retorna uma coleção ShapeNodes que representa a descrição geométrica da forma especificada.

OLEFormat Retorna um objeto OLEFormat que representa as características OLE além de vinculação da forma, da forma embutida ou do campo especificado. Somente leitura.

ParentGroup Retorna um objeto Shape que representa a forma pai comum de uma forma filha ou um intervalo de formas filhas.

PictureFormat Retorna um objeto PictureFormat que contém as propriedades de formatação da imagem para o objeto especificado. Somente leitura.

Reflection Retorna um objeto ReflectionFormat que representa a formatação de reflexo de uma forma. Somente leitura.

RelativeHorizontalPosition Especifica a posição horizontal relativa de uma forma. Leitura/gravação WdRelativeHorizontalPosition.

RelativeHorizontalSize Retorna ou define uma constante WdRelativeVerticalSize que representa o objeto ao qual um intervalo de formas é relativo. Leitura/gravação.

RelativeVerticalPosition Especifica a posição vertical relativa de uma forma. Leitura/gravação WdRelativeVerticalPosition.

RelativeVerticalSize Retorna ou define uma constante WdRelativeVerticalSize 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. Um valor positivo indica rotação no sentido horário; um valor negativo indica rotação no sentido anti-horário. Leitura/gravação única.

Script Retorna um objeto script , que representa um bloco de script ou código para uma imagem em uma página da Web.

Shadow Retorna um objeto ShadowFormat que representa a formatação de sombra para a forma especificada.

ShapeStyle Retorna ou define o estilo de forma para a forma especificada. Leitura/gravação MsoShapeStyleIndex.

SmartArt Retorna um objeto SmartArt que fornece uma maneira de trabalhar com o SmartArt associado à forma especificada. Somente leitura.

SoftEdge Retorna um objeto SoftEdgeFormat que representa a formatação de borda suave para uma forma. Somente leitura.

TextEffect Retorna um objeto TextEffectFormat que contém as propriedades de formatação de efeito de texto para a forma especificada. Somente leitura.

TextFrame Retorna um objeto TextFrame que contém o texto da forma especificada.

TextFrame2 Retorna um objeto TextFrame2 que contém o texto da forma especificada. Somente leitura.

ThreeD Retorna um objeto ThreeDFormat que contém as propriedades de formatação 3D para a forma especificada. Somente leitura.

Title Retorna ou define uma cadeia de caracteres que contém um título para a forma especificada. Leitura/gravação.

Top Retorna ou define a posição vertical da forma especificada ou do intervalo de forma em pontos. Leitura/gravação única.

TopRelative Retorna ou define um valor único que representa a posição superior relativa de uma forma. Leitura/gravação.

Type Retorna o tipo de forma embutida. Somente leitura MsoShapeType.

VerticalFlip True se a forma especificada for invertida ao redor do eixo vertical. Somente leitura MsoTriState.

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. somente leitura.

Visible True se o objeto especificado ou a formatação aplicada a ele, está visível. MsoTriState para leitura/gravação.

Width Retorna ou define a largura, em pontos, da forma especificada. Long de leitura/gravação.

WidthRelative Retorna ou define um valor único que representa a largura relativa de uma forma. Leitura/gravação.

WrapFormat Retorna um objeto WrapFormat que contém as propriedades de quebra de texto ao redor da forma especificada. Somente leitura.

ZOrderPosition Retorna um Long que representa a posição da forma especificada na ordem z. Somente leitura.

Adjustments - Contém uma coleção de valores de ajuste para o objeto AutoShape ou WordArt especificado. Cada valor de ajuste representa uma maneira pela qual uma alça de ajuste pode ser ajustada. Como algumas alças de ajuste podem ser ajustadas—de duas maneiras por instância, algumas alças podem ser ajustadas horizontal—e verticalmente, uma forma pode ter mais valores de ajuste do que as alças de ajuste. Uma forma pode ter até oito ajustes.

CalloutFormat - Contém propriedades e métodos que se aplicam a textos explicativos de linha.

CanvasShapes - Use a propriedade CanvasItems de um objeto Shape ou ShapeRange para retornar uma coleção CanvasShapes .

Chart - Representa um documento em uma pasta de trabalho.

FillFormat - Representa a formatação de preenchimento de uma forma. Uma forma pode ter um preenchimento sólido, gradual, texturizado, padronizado, de figura ou semitransparente.

GlowFormat - Representa a formatação de brilho para uma forma ou intervalo de formas.

GroupShapes - Representa as formas individuais dentro de uma forma agrupada. Cada forma contida em um grupo de formas é representada por um objeto Shape .

Hyperlink - Representa um hiperlink. Objeto Hyperlink é membro dos hiperlinks coleção.

InlineShape - Representa um objeto na camada de texto de um documento. Uma forma embutida somente pode ser uma imagem, um objeto OLE ou um controle ActiveX. O objeto InlineShape é um membro do InlineShapes coleção. A coleção InlineShapes contém todas as formas que aparecem embutida em um documento, intervalo ou seleção.

LineFormat - Representa formatação de linha e ponta de seta. Para uma linha, o objeto LineFormat contém informações de formatação para a própria linha; para uma forma com uma borda, esse objeto contém informações de formatação para a borda da forma.

LinkFormat - Representa as características de vinculação de uma figura ou objeto OLE.

Model3DFormat - Representa as propriedades de uma forma de modelo 3D.

OLEFormat - Representa as características OLE (diferentes de vinculação) de um objeto OLE, de um controle ActiveX ou de um campo.

PictureFormat - Contém propriedades e métodos que se aplicam a figuras e objetos OLE. O LinkFormat objeto contém propriedades e métodos que se aplicam a objetos OLE vinculados somente. O OLEFormat objeto contém propriedades e métodos que se aplicam a objetos OLE, estejam vinculados ou não.

Range - Representa uma área contígua em um documento. Cada objeto de intervalo é definido por uma posição de caractere inicial e final.

ReflectionFormat - Representa a formatação de reflexão de uma forma ou intervalo de formas.

ShadowFormat - Representa a formatação de sombra para uma forma.

ShapeNodes - Uma coleção de todos os ShapeNode objetos de forma livre especificada. Cada objeto ShapeNode representa um nó entre segmentos em uma forma livre ou um ponto de controle de um segmento curvo de uma forma livre.

ShapeRange - Representa um intervalo de formas, que é um conjunto de formas em um documento. O intervalo de formas pode conter desde uma única forma até todas as formas do documento.

SoftEdgeFormat - Representa a formação da borda flexível de uma forma ou de um intervalo de formas.

TextEffectFormat - Contém propriedades e métodos que se aplicam a objetos de WordArt.

TextFrame - Representa o quadro de texto em um objeto Shape . Objeto TextFrame contém o texto no quadro de texto e as propriedades que controlam as margens e a orientação do quadro do texto.

ThreeDFormat - Representa a formatação tridimensional de uma forma.

WrapFormat - Representa todas as propriedades para quebra de texto ao redor de uma forma ou de um intervalo de formas.