Compartilhar via

Objeto ShapeRange (PowerPoint)

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

Pode incluir as formas que pretender, escolhidas entre todas as formas do 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 descrição geral de como trabalhar com uma única forma ou com mais do que uma forma de cada vez, consulte Trabalhar com formas (objetos de desenho).

Os exemplos a seguir descrevem como:

  • Devolver um conjunto de formas que especificar por nome ou número de índice.

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

Exemplo

Utilize Shapes.Range (índice), em que í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 devolver uma coleção ShapeRange que representa um conjunto de formas num documento. Utilize a função Matriz 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 possa utilizar o método Intervalo para devolver qualquer número de formas ou diapositivos, é mais simples utilizar o método Item se quiser devolver apenas um único membro da coleção. Por exemplo, Shapes(1) é mais simples do que Shapes.Range(1).

Utilize a propriedade ShapeRange do objeto Selection para devolver 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)

Utilize Selection.ShapeRange (índice), em que índice é o nome da forma ou o número do índice, para devolver uma única forma na 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.

  • Last updated on