Objeto ShapeRange (PowerPoint)

  • Artigo

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.

Comentários

Você pode incluir todas as formas desejadas, escolhidas entre todas as formas no documento ou todas as formas na seleção, para construir um intervalo de formas. Por exemplo, você poderia construir uma coleção ShapeRange contendo as três primeiras formas em um documento, todas as formas selecionadas em um documento ou todas as formas livres em um documento.

Para obter uma visão geral de como trabalhar com uma única forma ou com mais de uma forma por vez, consulte Trabalhar com formas (objetos de desenho).

Os exemplos a seguir descrevem como:

  • Retorne um conjunto de formas que você especifica por nome ou número de índice.

  • Retornar algumas ou todas as formas selecionadas em um documento.

Exemplo

Use Shapes.Range (index), em que o índice é o nome ou o número de índice da forma ou uma matriz que contém nomes ou números de índice de formas, para retornar uma coleção ShapeRange que representa um conjunto de formas em um documento. Use a função Array para construir uma matriz de nomes ou números de índice. O exemplo a seguir define o padrão de preenchimento para as formas um e três em myDocument.

Set myDocument = ActivePresentation.Slides(1)

myDocument.Shapes.Range(Array(1, 3)).Fill _

    .Patterned msoPatternHorizontalBrick

O exemplo a seguir define o padrão de preenchimento para as formas chamadas Oval 4 e Rectangle 5 em myDocument.

Set myDocument = ActivePresentation.Slides(1)

Set myRange = myDocument.Shapes _

    .Range(Array("Oval 4", "Rectangle 5"))

myRange.Fill.Patterned msoPatternHorizontalBrick

Embora você possa usar o método Range para retornar qualquer número de formas ou slides, é mais simples usar o método Item se você quiser retornar apenas um único membro da coleção. Por exemplo, Shapes(1) é mais simples do que Shapes.Range(1).

Use a propriedade ShapeRange do objeto Selection para retornar todas as formas na seleção. O exemplo seguinte define o preenchimento do primeiro plano de cores para todas as formas da seleção na janela um, considerando que haja 's pelo menos uma forma da seleção.

Windows(1).Selection.ShapeRange.Fill.ForeColor _

    .RGB = RGB(255, 0, 255)

Use Selection.ShapeRange (índice), em que o índice é o nome da forma ou o número do índice, para retornar uma única forma dentro da seleção. O exemplo seguinte define a cor de primeiro plano de preenchimento para a forma dois na coleção de formas selecionadas na janela um, considerando que haja pelo menos duas formas na seleção.

Windows(1).Selection.ShapeRange(2).Fill.ForeColor _

    .RGB = RGB(255, 0, 255)

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.