Objeto Shape (Excel)

  • Artículo

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

Comentarios

El objeto Shape es 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 formas una y cuatro en el libro, o podría representar todas las formas seleccionadas en el 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.

Regresar... Uso...
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 lo representa.
Objeto Shape que representa una sola forma en 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 intervalo de formas y devolver un único objeto Shape que representa el grupo recién formado. Una vez formado un grupo, puede trabajar con el grupo de la misma manera que trabaja con cualquier otra forma.
Objeto Shape que representa una forma existente Formas (índice), donde índice es el nombre de la forma o el número de índice.
Objeto Shape que representa una forma dentro de la selección Selección. ShapeRange (índice), 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 asigna el nombre Cuadrado rojo y, a continuación, se establece su color de primer plano y su 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.