Objeto ShapeRange (Excel)ShapeRange object (Excel)

Representa un rango de formas, que es un conjunto de formas en un documento.Represents a shape range, which is a set of shapes on a document.

ComentariosRemarks

Un intervalo de formas puede estar compuesto por una única forma o por todas las formas del documento.A shape range can contain as few as a single shape or as many as all the shapes on the document. 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.You can include whichever shapes you want—chosen from among all the shapes on the document or all the shapes in the selection—to construct a shape range. 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.For example, you could construct a ShapeRange collection that contains the first three shapes on a document, all the selected shapes on a document, or all the freeforms on a document.

EjemploExample

Devolver un conjunto de formas especificadas por nombre o por número de índiceReturn a set of shapes that you specify by name or index number

Use Range (Índice), donde Índice es el nombre o número de índice de la forma o una matriz que contenga los nombres o números de índice de las formas, para devolver una colección ShapeRange que represente un conjunto de formas de un documento.Use Range (index), where index is the name or index number of the shape or an array that contains either names or index numbers of shapes, to return a ShapeRange collection that represents a set of shapes on a document. Puede usar la función Array para construir una matriz de nombres o números de índice.You can use the Array function to construct an array of names or index numbers.

En el siguiente ejemplo se configura el patrón de relleno para las formas una y tres en myDocument.The following example sets the fill pattern for shapes one and three on 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.The following example sets the fill pattern for the shapes named Oval 4 and Rectangle 5 on 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.Although you can use the Range property to return any number of shapes or slides, it's simpler to use the Item method if you want to return only a single member of the collection. Por ejemplo, Shapes(1) es más sencillo que Shapes.Range(1).For example, Shapes(1) is simpler than 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 documentoReturn all or some of the selected shapes on a document

Use la propiedad ShapeRange del objeto Selection para devolver todas las formas de la selección.Use the ShapeRange property of the Selection object to return all the shapes in the selection. 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.The following example sets the fill foreground color for all the shapes in the selection in window one, assuming that there's at least one shape in the selection.

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

Usar selección. ShapeRange (Índice), donde Índice es el nombre de la forma o el número de índice, para devolver una única forma de la selección.Use Selection.ShapeRange (index), where index is the shape name or the index number, to return a single shape within the selection. 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.The following example sets the fill foreground color for shape two in the collection of selected shapes in window one, assuming that there are at least two shapes in the selection.

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

MétodosMethods

PropiedadesProperties

Vea tambiénSee also

Soporte técnico y comentariosSupport and feedback

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.