Objeto ShapeRange (Word)

  • Artículo

Representa un intervalo de formas, que es un conjunto de formas de un documento. Un intervalo de formas puede contener una o varias formas, o incluso todas las formas del documento.

Comentarios

Puede incluir las formas que desee,elegidas entre todas las formas del documento o todas las formas de la selección, para construir un intervalo de formas. Por ejemplo, podría construir una colección ShapeRange que contenga las tres primeras formas en un documento, todas las formas seleccionadas o todas las formas libres de un documento. [!NOTA] La mayoría de las operaciones que se pueden hacer con un objeto Shape, también puede realizarlas con un objeto ShapeRange que contiene sólo una forma. Algunas operaciones, cuando se realizan en un objeto ShapeRange que contenga más de una forma, producirán un error.

Use Range (index), donde index es el nombre o número de índice de la forma o una matriz que contiene nombres o números de índice de formas, para devolver una colección ShapeRange que representa un conjunto de formas en un documento. Use la función Array de Visual Basic para construir una matriz de nombres o números de índice. En el ejemplo siguiente se establece la trama de relleno para las formas uno y tres del documento activo.

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

En el ejemplo siguiente se seleccionan las formas denominadas Oval 4 y Rectangle 5 en el documento activo.

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

Aunque puede utilizar el intervalo método para devolver cualquier número de formas, es más sencillo utilizar el elemento método si desea devolver a sólo un miembro de la colección. Por ejemplo, Shapes(1) es más sencillo que Shapes.Range(1).

Use ShapeRange (index), donde index es el nombre o el número de índice, para devolver un objeto Shape que representa una forma dentro de una selección. En el ejemplo siguiente se establece el relleno de la primera forma de la selección, suponiendo que la selección contiene una forma por lo menos.

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

En este ejemplo, se seleccionan todas las formas de la primera sección del documento activo.

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

Utilice el Alinear, distribuir o ZOrder método para colocar un conjunto de formas entre sí o con relación al documento.

Utilice el grupo, agrupar o Desagrupar método para crear y trabajar con una sola forma formado a partir de un intervalo de formas. La propiedad GroupItems de un objeto Shape devuelve el GroupShapes objeto, que representa todas las formas que estaban agrupadas para crear una sola forma.

La grabadora siempre utiliza la ShapeRange propiedad para grabar formas.

Nota:

[!NOTA] Un objeto ShapeRange no incluye InlineShape objetos.

Métodos

Propiedades

Vea también

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.