Objeto Shape (Excel)
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
- Apply
- Copy
- CopyPicture
- Cut
- Delete
- Duplicate
- Flip
- IncrementLeft
- IncrementRotation
- IncrementTop
- PickUp
- RerouteConnections
- ScaleHeight
- ScaleWidth
- Select
- SetShapesDefaultProperties
- Ungroup
- ZOrder
Propiedades
- Adjustments
- AlternativeText
- Application
- AutoShapeType
- BackgroundStyle
- BlackWhiteMode
- BottomRightCell
- Callout
- Chart
- Child
- ConnectionSiteCount
- Connector
- ConnectorFormat
- ControlFormat
- Creator
- Decorative
- Fill
- FormControlType
- Glow
- GraphicStyle
- GroupItems
- HasChart
- HasSmartArt
- Height
- HorizontalFlip
- Hyperlink
- ID
- Left
- Line
- LinkFormat
- LockAspectRatio
- Locked
- Model3D
- Nombre
- Nodes
- OLEFormat
- OnAction
- Parent
- ParentGroup
- PictureFormat
- Placement
- Reflection
- Rotation
- Shadow
- ShapeStyle
- SmartArt
- SoftEdge
- TextEffect
- TextFrame
- TextFrame2
- ThreeD
- Título
- Top
- TopLeftCell
- Type
- VerticalFlip
- Vertices
- Visible
- Width
- ZOrderPosition
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.