Objeto ShapeRange (Excel)

  • Artigo

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

Comentários

Um intervalo de formas pode conter apenas uma única forma ou todas as formas no documento. 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.

Exemplo

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

Use Range (index), em que index é 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 = Worksheets(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.

Embora seja possível usar a propriedade Range para retornar qualquer número de formas ou slides, é mais simples usar o método Item se você deseja retornar somente um único membro da coleção. Por exemplo, Shapes(1) é mais simples do que Shapes.Range(1).

Set myDocument = Worksheets(1) 
Set myRange = myDocument.Shapes.Range(Array("Oval 4", _ 
 "Rectangle 5")) 
myRange.Fill.Patterned msoPatternHorizontalBrick

Retornar todas ou algumas das formas selecionadas em um documento

Use a propriedade ShapeRange do objeto Selection para retornar todas as formas da 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 Seleção. 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.