Shape (objeto)

Importante

En este artículo es máquina traducido, vea la exención de responsabilidad. Encontrará la versión en inglés de este artículo aquí para su referencia.

Representa un objeto en la capa de dibujo, como una autoforma, una forma libre, objeto OLE, control de ActiveX o imagen. El objeto Shape es un miembro de la Shapes colección, que incluye todas las formas del contenido principal de un documento o de todos los encabezados y pies de página de un documento.

Observaciones

Las formas siempre se adjuntan a un intervalo de fijación. Puede colocar la forma en cualquier parte de la página que contenga el delimitador. Existen tres objetos que representan formas: la colección Shapes, que representa todas las formas de un documento; el objeto ShapeRange, que representa un subconjunto especificado de las formas de un documento como, por ejemplo, un objeto ShapeRange podría representar las formas una y cuatro del documento o todas las formas seleccionadas del documento; y el objeto Shape, que representa una sola forma del documento. Si desea trabajar con varias formas al mismo tiempo o con formas dentro de la selección, utilice una colección ShapeRange.

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 el siguiente 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 distintas a un documento, podrían denominarse: "Rectángulo 2", "CuadroTexto 3" y "Elipse 4". Para asignar a una forma un nombre más descriptivo, establezca la propiedad Name.

Utilice la sintaxis ShapeRange(Index), donde Index corresponde al nombre o al número de índice, para devolver un objeto Shape que represente a una forma dentro de una selección. En el ejemplo siguiente se establece el relleno de la primera forma de la selección, suponiendo que la selección contiene una forma por lo menos.

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

En el siguiente ejemplo se establece el relleno para todas las formas en la selección, suponiendo que la selección contiene al menos una forma.

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

Para agregar un objeto Shape a la colección de formas del documento especificado y devolver un objeto Shape que represente la forma recién creada, utilice uno de los siguientes métodos de la colección Shapes: AddCallout, AddCurve, AddLabel, AddLine, AddOleControl, AddOleObject, AddPolyline, AddShape, AddTextbox, AddTextEffect o BuildFreeForm. En el siguiente ejemplo, se agrega un rectángulo al documento activo.

ActiveDocument.Shapes.AddShape msoShapeRectangle, 50, 50, 100, 200

Utilice la sintaxis GroupItems(Index), donde Index corresponde al nombre o al número de índice de la forma, para devolver un objeto Shape que represente a una sola forma de una forma agrupada.

Utilice la Group o Regroup método para agrupar un intervalo de formas y devolver un objeto Shape único que representa el grupo recién formado. Después de que se ha formado un grupo, puede trabajar con el grupo de la misma manera que con cualquier otra forma.

Todos los objetos Shape se fijan a un intervalo de texto. La forma se fija al principio del primer párrafo que contiene el intervalo de fijación. La forma siempre permanecerá en la misma página que su delimitador.

Puede ver el delimitador estableciendo el ShowObjectAnchors propiedad de True. Top la forma y Left las propiedades determinan sus posiciones verticales y horizontales. RelativeHorizontalPosition la forma y RelativeVerticalPosition las propiedades determinan si la posición se mide desde el párrafo de fijación, la columna que contiene dicho párrafo, el margen o borde de la página.

Si la LockAnchor valor de la propiedad está establecida en True, no se puede arrastrar el marcador de posición en la página.

Utilice la propiedad Fill para devolver el FillFormat objeto que contiene todas las propiedades y métodos para dar formato al relleno de una forma cerrada. La propiedad Shadow devuelve el ShadowFormat objeto, que se utiliza para dar formato a una sombra. Utilice la propiedad Line para devolver la LineFormat objeto que contiene propiedades y métodos para dar formato a las líneas y flechas. La propiedad TextEffect devuelve el TextEffectFormat objeto, que se utiliza al formato de WordArt. La propiedad Callout devuelve el CalloutFormat objeto, que se utiliza para dar formato a las llamadas con línea. La propiedad WrapFormat devuelve el WrapFormat objeto que se utiliza para definir cómo se ajusta el texto alrededor de formas. La propiedad ThreeD devuelve el ThreeDFormat objeto, que se utiliza para crear formas 3D. Puede utilizar el PickUp y Apply métodos para transferir formato de una forma a otra.

Utilice la SetShapesDefaultProperties método para un objeto Shape establecer el formato de la forma predeterminada para el documento. Las nuevas formas heredan muchos de sus atributos de la forma predeterminada.

Utilice la Type propiedad para especificar el tipo de forma: forma libre, autoforma, objeto OLE, llamada o imagen vinculada, por ejemplo. Utilice la AutoShapeType propiedad para especificar el tipo de autoforma: elipse, rectángulo o globo, por ejemplo.

Utilice la Width y Height propiedades para especificar el tamaño de la forma.

La propiedad TextFrame devuelve el TextFrame objeto que contiene todas las propiedades y métodos para adjuntar texto a las formas y vincular el texto entre marcos de texto.

objetos de Shape se fijan a un intervalo de texto, pero son objetos flotantes y pueden situarse en cualquier lugar en la página. InlineShape los objetos se tratan como caracteres y se colocan como caracteres dentro de una línea de texto. Puede utilizar el ConvertToInlineShape método y la ConvertToShape método para convertir las formas de un tipo a otro. Puede convertir sólo las imágenes, objetos OLE y controles de ActiveX a las formas en línea.

Nota

Declinación de responsabilidades de traducción automática: Este artículo se ha traducido con un sistema informático sin intervención humana. Microsoft ofrece estas traducciones automáticas para que los hablantes de otros idiomas distintos del inglés puedan disfrutar del contenido sobre los productos, los servicios y las tecnologías de Microsoft. Puesto que este artículo se ha traducido con traducción automática, es posible que contenga errores de vocabulario, sintaxis o gramática.