Objeto Shapes (Word)
Una colección de forma objetos que representan todas las formas de un documento o todas las formas de todos los encabezados y pies de página de un documento. Cada objeto Shape representa un objeto en la capa de dibujo, como una autoforma, una forma libre, un objeto OLE o una imagen.
Comentarios
Si desea trabajar con un subconjunto de las formas de un documento, por ejemplo, para hacer algo únicamente con las autoformas del documento o sólo las formas seleccionadas, debe construir un objeto ShapeRange colección que contiene las formas que desea trabajar.
Utilizar las formas propiedad para devolver la colección Shapes. El ejemplo siguiente selecciona todas las formas del documento activo.
ActiveDocument.Shapes.SelectAll
Nota:
[!NOTA] Si desea hacer algo (como eliminar o establecer una propiedad) a todas las formas de un documento al mismo tiempo, utilice el intervalo método para crear un objeto ShapeRange que contenga todas las formas de la colección Shapes y, a continuación, aplique la propiedad adecuada o método al objeto ShapeRange.
Use uno de los métodos siguientes de la colección Shapes : Add3DModel, AddCallout, AddCurve, AddLabel, AddLine, AddOleControl, AddOleObject, AddPolyline, AddShape, AddTextbox, AddTextEffect o BuildFreeForm para agregar una forma a un documento que devuelva un objeto Shape que represente la forma recién creada. En el ejemplo siguiente se agrega un rectángulo al documento activo.
ActiveDocument.Shapes.AddShape msoShapeRectangle, 50, 50, 100, 200
Utilice la sintaxis Shapes (Index), donde Index corresponde al nombre o al número de índice, para devolver un solo objeto Shape. En el ejemplo siguiente se voltea horizontalmente la forma uno del documento activo.
ActiveDocument.Shapes(1).Flip msoFlipHorizontal
En este ejemplo, se voltea horizontalmente la forma denominada "Rectangle 1" del documento activo.
ActiveDocument.Shapes("Rectangle 1").Flip msoFlipHorizontal
Cada forma recibe un nombre predeterminado al crearla. Por ejemplo, si agrega tres formas diferentes a un documento, podrían denominarse "Rectángulo 2", "Cuadro de texto 3" y "Oval 4". Para asignar un nombre más significativo a una forma, establezca la propiedad Name .
La colección Shapes no incluye InlineShape objetos. Los objetos InlineShape se tratan y se colocan como caracteres dentro de una línea de texto. Los objetos Shape se fijan a un intervalo de texto, pero son objetos flotantes y pueden situarse en cualquier lugar de la página. Use el método ConvertToInlineShape y el método ConvertToShape para convertir formas de un tipo a otro. Puede convertir sólo imágenes, objetos OLE y controles ActiveX en formas entre líneas.
La propiedad Count de esta colección de un documento devuelve el número de elementos sólo del artículo principal. Para contar las formas de todos los encabezados y pies de página, utilice la colección Shapes con cualquier objeto HeaderFooter.
Métodos
Propiedades
| Nombre |
|---|
| Aplicación |
| Count |
| Creator |
| Parent |
Vea también
Referencia de modelos de objetos de Word
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.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de