Objeto Shape (Excel)

Representa un objeto de la capa de dibujo, como una autoforma, una forma libre, un objeto OLE o una imagen.

Observaciones

El objeto Shape es un miembro de la colección Shapes. La colección Shapes contiene todas las figuras de un libro.

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 podría representar las formas uno y cuatro del libro o podría representar todas las formas seleccionadas del libro); y el objeto Shape, que representa una sola forma en una hoja de cálculo. Si desea trabajar con varias formas al mismo tiempo o con formas dentro de la selección, use una colección ShapeRange.

Para devolver... Usar...
Un objeto Shape que representa una de las formas adjuntas por un conector Propiedad BeginConnectedShape o EndConnectedShape del objeto ConnectorFormat.
Una forma libre recién creada 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.
Un objeto Shape que representa una sola forma de una forma agrupada GroupItems (index), donde index es el nombre de la forma o el número de índice dentro del grupo.
Un grupo de formas recién formado El método Group o Regroup del objeto ShapeRange para agrupar un rango de formas y devolver un único objeto Shape que representa el grupo recién formado. Después de formar un grupo, puede trabajar con el grupo del mismo modo que con cualquier otra forma.
Un objeto Shape que representa una forma existente Shapes (index), donde index es el nombre de la forma o el número de índice.
Un objeto Shape que representa una forma dentro de la selección Selección. ShapeRange (index), donde index es el nombre de la forma o el número de índice.

Ejemplo

El siguiente ejemplo voltea horizontalmente la forma uno y la forma denominada Rectangle 1 en 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. Para dar a la forma un nombre más significativo, use la propiedad Name. En el ejemplo siguiente se agrega un rectángulo a myDocument, se le da el nombre Red Square y, a continuación, se establece el color de primer plano y el estilo de línea.

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.

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

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.