Objeto ShapeRange (Excel)

  • Artículo

Representa un rango de formas, que es un conjunto de formas en un documento.

Comentarios

Un intervalo de formas puede estar compuesto por una única forma o por todas las formas del documento. 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, se puede construir una colección ShapeRange que contenga las tres primeras formas de un documento, todas las formas seleccionadas de un documento o todas las formas libres de un documento.

Ejemplo:

Devolver un conjunto de formas que especifique por nombre o número de índice

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 para construir una matriz de nombres o números de índice.

En el siguiente ejemplo se configura el patrón de relleno para las formas una y tres en myDocument.

Set myDocument = Worksheets(1) 
myDocument.Shapes.Range(Array(1, 3)).Fill.Patterned _ 
 msoPatternHorizontalBrick

En el siguiente ejemplo se configura el patrón de relleno para las formas denominadas Oval 4 y Rectangle 5 en myDocument.

Aunque se puede usar la propiedad Range para devolver cualquier número de formas o diapositivas, resulta más sencillo usar el método Item si solo se desea devolver un único miembro de la colección. Por ejemplo, Shapes(1) es más sencillo que Shapes.Range(1).

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

Devolver todas o algunas de las formas seleccionadas en un documento

Use la propiedad ShapeRange del objeto Selection para devolver todas las formas de la selección. El siguiente ejemplo se establece el primer plano del relleno de color de todas las formas de la selección en la ventana uno, suponiendo que haya 's al menos una forma en la selección.

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

Use Selección. ShapeRange (índice), donde index es el nombre de la forma o el número de índice, para devolver una sola forma dentro de la selección. El siguiente ejemplo se establece el primer plano del relleno de color para la forma dos de la colección de formas seleccionadas en la ventana uno, suponiendo que haya al menos dos formas en la selección.

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

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.