Objeto ShapeRange (Word)

  • Artigo

Representa um intervalo de formas, que é um conjunto de formas em um documento. O intervalo de formas pode conter desde uma única forma até todas as formas do documento.

Comentários

Você pode incluir todas as formas desejadas, 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. [!OBSERVAçãO] Maioria das operações que você pode fazer com um objeto Shape, você também pode fazer com um objeto ShapeRange que contenha apenas uma forma. Algumas operações, quando executadas em um objeto ShapeRange que contém mais de uma forma, causará um erro.

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 Matriz do Visual Basic para construir uma matriz de nomes ou números de índice. O exemplo a seguir define o padrão de preenchimento das formas um e três do documento ativo.

ActiveDocument.Shapes.Range(Array(1, 3)).Fill.Patterned _ 
 msoPatternHorizontalBrick

O exemplo a seguir seleciona as formas denominadas Oval 4 e Retângulo 5 no documento ativo.

ActiveDocument.Shapes.Range(Array("Oval 4", "Rectangle 5")).Select

Embora seja possível usar o intervalo método para retornar qualquer número de formas, é mais simples usar o Item método se desejar retornar apenas um único membro da coleção. Por exemplo, Shapes(1) é mais simples do que Shapes.Range(1).

Use ShapeRange (index), em que index é o nome ou o número do índice, para retornar um objeto Shape que representa uma forma dentro de uma seleção. O exemplo seguinte define o preenchimento da primeira forma da seleção, assumindo que a seleção contenha pelo menos uma forma.

Selection.ShapeRange(1).Fill.ForeColor.RGB = RGB(255, 0, 0)

Este exemplo seleciona todas as formas da primeira seção do documento ativo.

Set myRange = ActiveDocument.Sections(1).Range 
myRange.ShapeRange.Select

Usar a Alinhar, Distribuir ou ZOrder método para posicionar um conjunto de formas em relação umas às outras ou em relação ao documento.

Usar o grupo, Regroup ou Desagrupar método para criar e trabalhar com uma única forma formada de um intervalo de formas. A propriedade GroupItems um objeto Shape retorna a GroupShapes objeto que representa todas as formas que foram agrupadas para formar uma forma.

O gravador sempre usa o ShapeRange propriedade ao gravar formas.

Observação

[!OBSERVAçãO] Um objeto ShapeRange não inclui InlineShape objetos.

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.