Objeto Shape (Excel)Shape object (Excel)

Representa un objeto de la capa de dibujo, como una autoforma, una forma libre, un objeto OLE o una imagen.Represents an object in the drawing layer, such as an AutoShape, freeform, OLE object, or picture.

ObservacionesRemarks

El objeto Shape es un miembro de la colección Shapes .The Shape object is a member of the Shapes collection. La colección Shapes contiene todas las figuras de un libro.The Shapes collection contains all the shapes in a workbook.

Nota

Hay tres objetos que representan formas: la colección Shapes , que representa todas las formas de un libro; la colección ShapeRange , que representa un subconjunto especificado de las formas de un libro (por ejemplo, un objeto ShapeRange puede representar las formas uno y cuatro del libro, o puede representar todas las formas seleccionadas en el libro); y el objeto Shape , que representa una sola forma de una hoja de cálculo.There are three objects that represent shapes: the Shapes collection, which represents all the shapes on a workbook; the ShapeRange collection, which represents a specified subset of the shapes on a workbook (for example, a ShapeRange object could represent shapes one and four in the workbook, or it could represent all the selected shapes in the workbook); and the Shape object, which represents a single shape on a worksheet. Si desea trabajar con varias formas al mismo tiempo o con formas dentro de la selección, use una colección ShapeRange.If you want to work with several shapes at the same time or with shapes within the selection, use a ShapeRange collection.

Para devolver...To return... Use...Use...
Un objeto Shape que representa una de las formas Unidas por un conectorA Shape object that represents one of the shapes attached by a connector La propiedad BeginConnectedShape o EndConnectedShape del objeto ConnectorFormat .The BeginConnectedShape or EndConnectedShape property of the ConnectorFormat object.
Una forma libre recién creadaA newly created freeform Los métodos BuildFreeform y AddNodes para definir la geometría de una nueva forma libre y usar el método ConvertToShape para crear la forma libre y devolver el objeto Shape que la representa.The BuildFreeform and AddNodes methods to define the geometry of a new freeform, and use the ConvertToShape method to create the freeform and return the Shape object that represents it.
Un objeto Shape que representa una sola forma de una forma agrupadaA Shape object that represents a single shape in a grouped shape GroupItems (Índice), donde Índice es el nombre de la forma o el número de índice dentro del grupo.GroupItems (index), where index is the shape name or the index number within the group.
Un grupo de formas recién creadoA newly formed group of shapes El método Group o Regroup del objeto ShapeRange para agrupar un intervalo de formas y devolver un único objeto Shape que representa el grupo recién creado. The Group or Regroup method of the ShapeRange object to group a range of shapes and return a single Shape object that represents the newly formed group. Una vez que se ha formado un grupo, puede trabajar con el grupo de la misma forma que trabaja con cualquier otra forma.After a group has been formed, you can work with the group the same way that you work with any other shape.
Un objeto Shape que representa una forma existenteA Shape object that represents an existing shape Formas (Índice), donde Índice es el nombre de la forma o el número de índice.Shapes (index), where index is the shape name or the index number.
Un objeto Shape que representa una forma dentro de la selección.A Shape object that represents a shape within the selection Selección. ShapeRange (Índice), donde Índice es el nombre de la forma o el número de índice.Selection.ShapeRange (index), where index is the shape name or the index number.

EjemploExample

El siguiente ejemplo voltea horizontalmente la forma uno y la forma denominada Rectangle 1 en myDocument.The following example horizontally flips shape one and the shape named Rectangle 1 on myDocument.

Set myDocument = Worksheets(1) 
myDocument.Shapes(1).Flip msoFlipHorizontal 
myDocument.Shapes("Rectangle 1").Flip msoFlipHorizontal

Cada forma lleva asignado un nombre predeterminado cuando se agrega a la colección Shapes.Each shape is assigned a default name when you add it to the Shapes collection. Para dar a la forma un nombre más significativo, use la propiedad Name.To give the shape a more meaningful name, use the Name property. En el siguiente ejemplo se agrega un rectángulo a myDocument, se le asigna el nombre de cuadrado rojo y, a continuación, se establece el color de primer plano y el estilo de línea.The following example adds a rectangle to myDocument, gives it the name Red Square, and then sets its foreground color and line style.

Set myDocument = Worksheets(1) 
With myDocument.Shapes.AddShape(msoShapeRectangle, _ 
 144, 144, 72, 72) 
 .Name = "Red Square" 
 .Fill.ForeColor.RGB = RGB(255, 0, 0) 
 .Line.DashStyle = msoLineDashDot 
End With

El siguiente ejemplo configura el relleno para la primera forma de la selección en la ventana activa, asumiendo que hay al menos una forma en la selección.The following example sets the fill for the first shape in the selection in the active window, assuming that there's at least one shape in the selection.

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

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.