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

A classe Shape representa um objeto na camada de desenho, como uma AutoForma, uma forma livre, um objeto OLE ou uma imagem.

As classes Comment, ConnectorFormat, FreeformBuilder, Hyperlink, PivotCache, PivotTable, Slicer e Window. dão acesso à classe Shape

For Each

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


For Each s In Worksheets(1).Shapes 
    If s.HorizontalFlip Then s.Flip msoFlipHorizontal 
    If s.VerticalFlip Then s.Flip msoFlipVertical 
Next

Métodos

Apply - Aplica-se à formatação de forma especificada que foi copiada usando o método pickup .

Copy - Copia o objeto para a Área de Transferência.

CopyPicture - Copia o objeto selecionado para a Área de Transferência como uma imagem.

Cut - Recorta o objeto para a Área de Transferência.

Delete - Exclui o objeto.

Duplicate - Duplica o objeto e retorna uma referência para a nova cópia.

Flip - Inverte a forma especificada ao redor de seu eixo horizontal ou vertical.

IncrementLeft - Move a forma especificada horizontalmente 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. Use a propriedade Rotation para definir a rotação absoluta da forma.

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

PickUp - Copia a formatação da forma especificada. Use o método Apply para aplicar a formatação copiada a outra forma.

RerouteConnections - Este método redireciona todos os conectores anexados à forma especificada; se a forma especificada for um conector, ela será redirecionada.

ScaleHeight - Dimensiona a altura da forma por um fator especificado. Para imagens e objetos OLE, você pode indicar se deseja dimensionar a forma em relação ao tamanho original ou atual. Formas que não sejam imagens ou objetos OLE são sempre dimensionadas em relação a sua altura atual.

ScaleWidth - Dimensiona a largura da forma por um fator especificado. Para imagens e objetos OLE, você pode indicar se deseja dimensionar a forma em relação ao tamanho original ou atual. Formas que não sejam imagens ou objetos OLE são sempre dimensionadas em relação à sua largura atual.

Select - Seleciona o objeto.

SetShapesDefaultProperties - Define a formatação da forma especificada como padrão para a mesma.

Ungroup - Desagrupa quaisquer formas agrupadas na forma especificada ou intervalo de formas. Desagrupa imagens e objetos OLE dentro da forma ou do intervalo de formas especificado.

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 na forma especificada. Aplica-se a qualquer objeto Shape que representa uma AutoForma, WordArt ou conector.

AlternativeText Retorna ou define a sequência de texto descritiva alternativa para um objeto Shape quando o objeto é salvo em uma página da Web. String de leitura/gravação.

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

BackgroundStyle Retorna ou define o estilo do segundo plano. Leitura/gravação MsoBackgroundStyleIndex.

BlackWhiteMode Retorna ou define um valor que indica a maneira pela qual a forma especificada aparecerá quando a apresentação for exibida em preto e branco. Leitura/gravação MsoBlackWhiteMode.

BottomRightCell Retorna um objeto Range que representa a célula que se encontra sob o canto inferior direito do objeto. Somente leitura.

Callout Retorna um objeto CalloutFormat que contém as propriedades de formatação de linha para a forma especificada. Aplica-se a um objeto Shape que representa textos explicativos de linha. Somente leitura.

Chart Retorna um objeto Chart que representa o gráfico contido na forma. Somente leitura.

Child Retorna msoTrue se a forma especificada for uma forma filha ou se todas as formas em um intervalo de formas forem formas filhas de um mesmo pai. Retorna MsoFalse se a forma selecionada não for uma forma filha. Retorna msoTriStateMixed se apenas algumas das formas selecionadas são formas filhas. MsoTriState somente leitura.

ConnectionSiteCount Retorna o número de locais de conexão na forma especificada. Long somente leitura.

Connector True se a forma especificada for um conector. MsoTriState somente leitura.

ConnectorFormat Retorna um objeto ConnectorFormat que contém propriedades de formatação de conector. Aplica-se a um objeto Shape que representa conectores. Somente leitura.

ControlFormat Retorna um objeto ControlFormat que contém as propriedades de controle do Microsoft Excel. Somente leitura.

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

Fill Retorna um objeto FillFormat para uma forma especificada ou um objeto ChartFillFormat para um gráfico especificado que contém propriedades de formatação de preenchimento para a forma ou gráfico. Somente leitura.

FormControlType Retorna o tipo de controle do Microsoft Excel. Somente leitura XlFormControl.

Glow Retorna um objeto GlowFormat para uma forma especificada que contém as propriedades de formatação de brilho para a 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. Use o método Item do objeto GroupShapes para retornar uma única forma do grupo. Aplica-se a objetos Shape representam formas agrupadas. Somente leitura.

HasChart Retorna se uma forma contém um gráfico. MsoTriState somente leitura.

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

Height Retorna ou define um valor único que representa a altura, em pontos, do objeto.

HorizontalFlip True se a forma especificada for invertida ao redor do eixo horizontal. MsoTriState somente leitura.

Hyperlink Retorna um objeto Hyperlink que representa o hiperlink para a forma.

ID Retorna um valor Longo que representa o tipo do objeto especificado.

Left Retorna ou define um valor único que representa a distância, em pontos, da borda esquerda do objeto à borda esquerda da coluna a em uma planilha ou à borda esquerda da área do gráfico (em um gráfico).

Line Retorna um objeto LineFormat que contém as propriedades para a forma especificada de formatação de linha. Para uma linha, o objeto lineformat representa a própria linha; para uma forma com uma borda, o objeto lineformat representa a borda. Somente leitura.

LinkFormat Retorna um objeto LinkFormat que contém propriedades de objeto OLE vinculado. Somente leitura.

LockAspectRatio True se a forma especificada mantiver suas proporções originais após o redimensionamento. False se você puder alterar a altura e a largura da forma, separadamente, ao redimensioná-la. MsoTriState de leitura/gravação.

Locked Retorna ou define um valor Boolean que indica se o objeto está bloqueado.

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

Name Retorna ou define um valor String que representa o nome do objeto.

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

OLEFormat Retorna um objeto OLEFormat que contém propriedades de objeto OLE. Somente leitura.

OnAction Retorna ou define o nome de uma macro que é executada quando o objeto especificado é escolhido. String de leitura/gravação.

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 a imagem de formatação de propriedades para a forma especificada. Aplica-se a um objeto Shape que representa imagens ou objetos OLE. Somente leitura.

Placement Retorna ou define um valor XlPlacement que representa a maneira como o objeto é anexado às células abaixo dele.

Reflection Retorna um objeto ReflectionFormat para uma forma especificada que contém as propriedades de formatação de reflexo da forma. Somente leitura.

Rotation Retorna ou define a rotação da forma, em graus. Somente leitura/gravação.

Shadow Retorna um objeto ShadowFormat somente leitura que contém propriedades de formatação de sombra para a forma especificada ou formas.

ShapeStyle Retorna ou define um valor MsoShapeStyleIndex que representa o estilo de forma do intervalo de formas. Leitura/gravação.

SmartArt Retorna um objeto que representa o SmartArt associado à forma. Somente leitura.

SoftEdge Retorna um objeto SoftEdgeFormat para uma forma especificada que contém propriedades de formatação de borda suave para a forma. Somente leitura.

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

TextFrame Retorna um objeto TextFrame que contém as propriedades de alinhamento e ancoragem para a forma especificada. Somente leitura.

TextFrame2 Retorna um objeto TextFrame2 que contém a formatação de texto para a forma especificada. Somente leitura.

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

Title Retorna ou define o título do texto alternativo associado à forma especificada. Leitura/gravação.

Top Retorna ou define um valor único que representa a distância, em pontos, da borda superior da forma mais superior no intervalo de formas até a borda superior da planilha.

TopLeftCell Retorna um objeto Range que representa a célula que está sob o canto superior esquerdo do objeto especificado. Somente leitura.

Type Retorna ou define um valor MsoShapeType que representa o tipo de forma.

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

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. Você pode usar a matriz retornada por esta propriedade como um argumento para o Método AddCurve ou AddPolyline . Somente leitura .

Visible Retorna ou define um valor MsoTriState que determina se o objeto está visível. Leitura/gravação.

Width Retorna ou define um valor único que representa a largura, em pontos, do objeto.

ZOrderPosition Retorna a posição da forma especificada, de acordo com a ordem z. Long somente leitura.

Adjustments - Contém uma coleção de valores de ajuste para o objeto AutoForma, WordArt ou conector especificado.

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

Chart - Representa um gráfico em uma pasta de trabalho.

ConnectorFormat - Contém propriedades e métodos que se aplicam a conectores.

ControlFormat - Contém propriedades de controle do Microsoft Excel.

FillFormat - Representa formatação de preenchimento para uma forma.

GroupShapes - Representa as formas individuais dentro de uma forma agrupada.

Hyperlink - Representa um hyperlink.

LineFormat - Representa formatação de linha e ponta de seta.

LinkFormat - Contém propriedades de objeto OLE vinculado.

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

OLEFormat - Contém propriedades de objeto OLE.

PictureFormat - Contém propriedades e métodos que se aplicam a imagens e objetos OLE.

Range - Representa uma célula, uma linha, uma coluna, uma seleção de células contendo um ou mais blocos contíguos de células ou um intervalo 3D.

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

ShapeNodes - Uma coleção de todos os objetos ShapeNode especificado forma livre.

ShapeRange - Representa um intervalo de formas, que é um conjunto de formas em um documento.

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

TextFrame - Representa o quadro de texto em um objeto Shape. Contém o texto do quadro de texto, assim como as propriedades e os métodos que controlam o alinhamento e a ancoragem do quadro de texto.

TextFrame2 - Representa o quadro de texto em um objeto Shape, ShapeRange ou ChartFormat .

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