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

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

As classes Cell, ConnectorFormat, DocumentWindow, Effect, FreeformBuilder, Presentation, ResampleMediaTask e Timing. dão acesso à classe Shape

Para usar uma variável de classe Shape, ela primeiro precisa ser instanciada por exemplo

Dim shp as Shape
Set shp = Dim lngX As Long: lngX = 
Dim lngY As Long: lngY = 
ActiveWindow.RangeFromPoint(X:=lngX, Y:=lngY)
Os procedimentos a seguir podem ser usados ​​para definir variáveis ​​do tipo Shape: Cell.Shape, ConnectorFormat.BeginConnectedShape, ConnectorFormat.EndConnectedShape, DocumentWindow.RangeFromPoint, Effect.Shape, FreeformBuilder.ConvertToShape, GroupShapes.Item, Placeholders.FindByName, Placeholders.Item, Presentation.DefaultShape, ResampleMediaTask.Shape, ParentGroup, ShapeRange.Group, ShapeRange.Item ...ShapeRange.ParentGroup, ShapeRange.Regroup, Shapes.Add3DModel, Shapes.AddCallout, Shapes.AddChart2, Shapes.AddConnector, Shapes.AddCurve, Shapes.AddInkShapeFromXML, Shapes.AddLabel, Shapes.AddLine, Shapes.AddMediaObject2, Shapes.AddMediaObjectFromEmbedTag, Shapes.AddOLEObject, Shapes.AddPicture, Shapes.AddPicture2, Shapes.AddPlaceholder, Shapes.AddPolyline, Shapes.AddShape, Shapes.AddSmartArt, Shapes.AddTable, Shapes.AddTextbox, Shapes.AddTextEffect, Shapes.AddTitle, Shapes.Item, Shapes.Title, Timing.TriggerShape.

Métodos

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

ApplyAnimation - Aplica a última animação selecionada ao objeto Shape .

ConvertTextToSmartArt - Converte o texto em um objeto Shape em um diagrama SmartArt.

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

Cut - Exclui o objeto especificado e o coloca na Área de transferência.

Delete - Exclui o objeto Shape especificado.

Duplicate - Cria uma duplicata do objeto Shape especificado, adiciona a nova forma à coleção Shapes e retorna um novo objeto ShapeRange . Os objetos duplicados são colocados no final da coleção Shapes.

Flip - Inverte a forma especificada ao redor de seu eixo 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. 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.

PickupAnimation - Seleciona todas as animações do objeto Shape .

RerouteConnections - Redireciona os conectores para que eles tomem o caminho mais curto possível entre as formas que conectam. Para fazer isso, o método RerouteConnections pode desanexar as extremidades de um conector e reanexá-las a sites de conexão diferentes nas formas conectadas.

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

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 seu tamanho original ou seu tamanho atual. As formas que não forem imagens e objetos OLE serão sempre dimensionadas em relação à sua largura atual.

Select - Seleciona o objeto especificado.

SetShapesDefaultProperties - Aplica a formatação forma padrão à forma especificada. As formas criadas após a utilização desse método terão essa formatação aplicada a elas como padrão.

Ungroup - Desagrupa quaisquer formas agrupadas na forma especificada ou intervalo de formas. Desmonta figuras e objetos OLE dentro da forma especificada ou o intervalo de formas. Retorna as formas desagrupadas como um único objeto ShapeRange .

UpgradeMedia - Converte um objeto de mídia herdado em um objeto de mídia atualizado.

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

ActionSettings Retorna um objeto ActionSettings que contém informações sobre a ação que ocorre quando o usuário clica ou move o mouse sobre o intervalo de texto ou forma especificado durante uma apresentação de slides. Somente leitura.

Adjustments Retorna um objeto Adjustments que contém valores de ajuste para todos os ajustes na forma especificada. Aplica-se a qualquer objeto Shape representando uma AutoForma, WordArt ou um conector. Somente leitura.

AlternativeText Retorna ou define o texto associado a uma forma em uma apresentação da Web. Leitura/gravação.

AnimationSettings Retorna um objeto AnimationSettings que representa todos os efeitos especiais que você pode aplicar à animação da forma especificada. 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, um desenho de forma livre ou um conector. Leitura/gravação.

BackgroundStyle Define ou retorna o estilo do plano de fundo do objeto especificado. Leitura/gravação.

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.

Callout Retorna um objeto CalloutFormat que contém as propriedades para a forma especificada de formatação do texto explicativo. Se aplica aos objetos Shape ou ShapeRange que representam textos explicativos de linha. Somente leitura.

Chart Retorna um objeto de gráfico do objeto de forma atual. Somente leitura.

Child MsoTrue 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.

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

Connector Determina se a forma especificada é um conector. Somente leitura.

ConnectorFormat Retorna um objeto ConnectorFormat que contém propriedades de formatação de conector. Se aplica aos objetos Shape ou ShapeRange que representam conectores. Somente leitura.

CustomerData Retorna um objeto CustomerData. Somente leitura.

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

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

Glow Retorna o formato de brilho da forma especificada. 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. Somente leitura.

HasChart Retorna se a forma representada pelo objeto especificado contém um quadro. Somente leitura.

HasInkXML Retorna um valor de enumeração MsoTriState que indica se a forma especificada contém XML de tinta que pode ser recuperado por meio da propriedade Shape.InkXML. Somente leitura.

HasSectionZoom

HasSmartArt Retorna true se o objeto de forma atual contiver um diagrama SmartArt. Somente leitura.

HasTable Retorna se a forma especificada é uma tabela. Somente leitura.

HasTextFrame Retorna se a forma especificada possui um quadro de texto. Somente leitura.

Height Retorna ou define a altura do objeto especificado, em pontos. Leitura/gravação.

HorizontalFlip Retorna se a forma especificada está invertida em torno do seu eixo horizontal. Somente leitura.

Id Retorna um Long que identifica a forma ou intervalo de formas. Somente leitura.

InkXML Retorna uma String que contém o InkActionML associado à forma especificada. Somente leitura.

IsNarration Especifica se o intervalo da forma especificada contém uma narração. Leitura/gravação.

Left Retorna ou define um valor único que representa a distância em pontos da borda esquerda da caixa delimitadora da forma até a borda esquerda do slide. Leitura/gravação.

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 as propriedades que são exclusivas de objetos OLE vinculados. Somente leitura.

LockAspectRatio Determina que a forma especificada mantenha as suas proporções originais ao ser redimensionada. Leitura/gravação.

MediaFormat Permite o acesso ao novo objeto de vídeo ou áudio. Somente leitura.

MediaType Retorna o tipo de mídia OLE. Somente leitura.

Model3D Retorna um objeto Model3DFormat que representa as propriedades 3D de um objeto de modelo 3D. Somente leitura.

Name Quando uma forma é criada, o Microsoft PowerPoint atribui automaticamente a ele um nome no número de _forma_FORMTYPE, onde ShapeType identifica o tipo de forma ou AutoForma e o número é um inteiro exclusivo dentro da coleção de formas no slide. Por exemplo, os nomes das formas gerados automaticamente em um slide poderiam ser Espaço Reservado 1, Oval 2 e Retângulo 3. Para evitar o conflito com os nomes atribuídos automaticamente, não use a forma Número do Tipo de Forma para nomes definidos pelo usuário, onde Tipo de Forma é um valor usado para nomes gerados automaticamente e Número é um número inteiro positivo. Um intervalo de formas deve conter exatamente uma forma. Leitura/gravação.

Nodes Retorna uma coleção ShapeNodes que representa a descrição geométrica da forma especificada. Se aplica aos objetos Shape que representam desenhos de forma livre.

OLEFormat Retorna um objeto OLEFormat que contém as propriedades para a forma especificada de formatação OLE. Se aplica aos objetos Shape ou ShapeRange que representam os objetos OLE. 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 a imagem de formatação de propriedades para a forma especificada. Somente leitura.

PlaceholderFormat Retorna um objeto PlaceholderFormat que contém as propriedades que são exclusivas de espaços reservados. Somente leitura.

Reflection Retorna o formato de reflexão da forma especificada. Somente leitura.

Rotation Retorna ou define o número de graus em que a forma especificada é girada ao redor do eixo z. Leitura/gravação.

Shadow Retorna um objeto ShadowFormat que contém propriedades de formatação de sombras para a forma especificada. Somente leitura.

ShapeStyle Define ou retorna o índice de estilo de forma do objeto especificado. Leitura/gravação.

SmartArt Retorna um objeto do Microsoft Office SmartArt que representa o diagrama de SmartArt do objeto Shape. Somente leitura.

SoftEdge Retorna o formato de borda suave para a forma especificada. Somente leitura.

Table Retorna um objeto Table que representa uma tabela em uma forma ou em um intervalo de formas. Somente leitura.

Tags Retorna um objeto Tags que representa as marcas do objeto especificado. 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 o alinhamento e ancoragem propriedades para a forma especificada ou estilo de texto mestre.

TextFrame2 Retorna o objeto TextFrame2 associado ao objeto Shape especificado que contém as propriedades de alinhamento e ancoragem 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 um objeto Shape que representa o título do slide. Somente leitura.

Top Retorna ou define um valor único que representa a distância entre a borda superior da caixa delimitadora da forma até a borda superior do documento. Leitura/gravação.

Type Representa o tipo de forma ou de formas em um intervalo de formas. Somente leitura.

VerticalFlip Determina se a forma especificada está invertida em torno do seu eixo vertical. Somente leitura.

Vertices Retorna as coordenadas dos vértices do desenho de forma livre especificado e os pontos de controle das curvas de Bézier como uma sequência de pares de coordenadas. Somente leitura.

Visible Retorna ou define a visibilidade do objeto especificado ou da formatação que lhe foi aplicada. Leitura/gravação.

Width Retorna ou define a largura do objeto especificado, em pontos. Leitura/gravação.

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

ActionSettings - Uma coleção que contém os dois objetos ActionSetting para um intervalo de texto ou forma. Um objeto ActionSetting representa como o objeto especificado reage quando o usuário clica nele durante uma apresentação de slides e o outro objeto ActionSetting representa como o objeto especificado reage quando o usuário move o ponteiro do mouse sobre ele durante uma apresentação de slides.

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

AnimationSettings - Representa os efeitos especiais aplicados à animação da forma especificada durante uma apresentação de slides.

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

Chart - Representa um gráfico em uma apresentação.

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

CustomerData - Armazena informações sobre um cliente (como nome, endereço, número de telefone e assim por diante) ou outras informações no formato XML, como uma coleção de objetos CustomXMLPart associados a um objeto do Microsoft PowerPoint.

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.

GroupShapes - Representa as formas individuais dentro de uma forma agrupada. Cada forma é representada por um objeto Shape. Usando o método Itemcom esse objeto, você pode trabalhar com formas individuais dentro de um grupo sem precisar desagrupá-las.

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 - Contém propriedades e métodos que se aplicam a objetos OLE vinculados, imagens vinculadas e objetos de mídia IIRC.

MediaFormat - Contém métodos e propriedades que permitem o acesso e o controle sobre as mídias de áudio e vídeo.

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

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

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

PlaceholderFormat - Contém propriedades que se aplicam especificamente a espaços reservados, tais como o tipo do espaço reservado.

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

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

ShapeRange - Representa um intervalo de formas, que consiste em um conjunto de formas em um documento. Um intervalo de formas pode conter apenas uma forma ou todas as formas do documento.

Table - Representa uma forma de tabela em um slide. O objeto Table é um membro da coleção Shapes. O objeto Table contém as colunas coleção e as linhas coleção.

Tags - Representa uma marca ou uma propriedade personalizada que você pode criar para uma forma, um slide ou uma apresentação.

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

TextFrame - Representa o quadro de texto em um objeto Shape. Contém o texto no quadro de texto e propriedades e métodos que controlam o alinhamento e ancoragem do quadro de texto.

TextFrame2 - Representa o quadro de texto em um objeto Shape ou ShapeRange. Contém o texto no quadro de texto e expõe propriedades e métodos que controlam o alinhamento e a ancoragem do quadro de texto.

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