Shape Interfaz

Definición

Espacio de nombres:

Microsoft.Office.Interop.Word

Ensamblado:

Microsoft.Office.Interop.Word.dll

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

public interface class Shape

[System.Runtime.InteropServices.Guid("000209A0-0000-0000-C000-000000000046")]
public interface Shape

type Shape = interface

Public Interface Shape

Atributos

GuidAttribute

Comentarios

El Shape objeto es miembro de la Shapes colección, que incluye todas las formas del artículo principal de un documento o de todos los encabezados y pies de página de un documento.

Las formas siempre se adjuntan a un intervalo de fijación. Puede colocar la forma en cualquier lugar de la página que contiene el delimitador.

Hay tres objetos que representan formas: la Shapes colección, que representa todas las formas de un documento; la ShapeRange colección, que representa un subconjunto especificado de las formas de un documento (por ejemplo, un ShapeRange objeto podría representar formas uno y cuatro en el documento, o podría representar todas las formas seleccionadas en el documento); el Shape objeto , que representa una sola forma en un documento. Si desea trabajar con varias formas al mismo tiempo o con formas dentro de la selección, use una ShapeRange colección.

Use Shapes(index), donde index es el nombre o el número de índice, para devolver un solo Shape objeto.

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 un nombre más significativo a una forma, establezca la Name propiedad .

Use Selection.ShapeRange(index), donde index es el nombre o el número de índice, para devolver un Shape objeto que representa una forma dentro de una selección.

Para agregar un Shape objeto a la colección de formas del documento especificado y devolver un Shape objeto que represente la forma recién creada, use uno de los métodos siguientes de la Shapes colección: AddCallout(MsoCalloutType, Single, Single, Single, Single, Object), AddCurve(Object, Object), , AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object), AddLine(Single, Single, Single, Single, Object), AddOLEControl(Object, Object, Object, Object, Object, Object), AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)AddPolyline(Object, Object), AddShape(Int32, Single, Single, Single, Single, Object), AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object), AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object)o BuildFreeform(MsoEditingType, Single, Single).

Use GroupItems(index), donde index es el nombre de la forma o el número de índice dentro del grupo, para devolver un objeto Shape que representa una sola forma en una forma agrupada.

Use el Group() método o Regroup() para agrupar un intervalo de formas y devolver un único Shape objeto que represente el grupo recién formado. Una vez creado un grupo, puede trabajar con el grupo de la misma manera que con cualquier otra forma.

Cada Shape objeto se delimita 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 propio delimitador estableciendo la propiedad en ShowObjectAnchorsTrue. Las propiedades y Left de la Top forma determinan sus posiciones verticales y horizontales. Las propiedades y RelativeVerticalPosition de RelativeHorizontalPosition la forma determinan si la posición se mide desde el párrafo delimitador, la columna que contiene el párrafo delimitador, el margen o el borde de la página.

Si la LockAnchor propiedad de la forma está establecida en True, no se puede arrastrar el delimitador desde su posición en la página.

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

Use el SetShapesDefaultProperties() método de un Shape objeto para establecer el formato de la forma predeterminada del 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: oval, rectángulo o globo, por ejemplo.

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

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

Shape Los objetos están delimitados a un intervalo de texto, pero son flotantes y se pueden colocar en cualquier parte de la página. InlineShape Los objetos se tratan como caracteres y se colocan como caracteres dentro de una línea de texto. Puede usar el ConvertToInlineShape() método y el ConvertToShape() método para convertir formas de un tipo a otro. Puede convertir sólo imágenes, objetos OLE y controles ActiveX en formas entre líneas.

Propiedades

Adjustments	Devuelve un Adjustments objeto que contiene valores de ajuste para todos los ajustes del objeto especificado Shape que representa una autoforma o WordArt.
AlternativeText	Devuelve o establece el texto alternativo asociado con una forma en una página Web.
Anchor	Devuelve un Range objeto que representa el intervalo de anclaje de la forma especificada.
AnchorID	Representa un objeto en la capa de dibujo, como una autoforma, una forma libre, objeto OLE, control ActiveX o imagen.
Application	Devuelve un Application objeto que representa la aplicación microsoft Word.
AutoShapeType	Devuelve o establece el tipo de forma del objeto especificado Shape , que debe representar una autoforma distinta de una línea o un dibujo de forma libre.
BackgroundStyle	Obtiene o establece el estilo de fondo de la forma especificada.
Callout	Devuelve un CalloutFormat objeto que contiene propiedades de formato de llamada para la forma especificada.
CanvasItems	Devuelve un CanvasShapes objeto que representa una colección de formas en un lienzo de dibujo.
Chart	Devuelve un Chart objeto que representa un gráfico dentro de la colección de formas de un documento. Solo lectura.
Child	Determina si la forma es una forma secundaria.
ConnectionSiteCount	Reservado para uso interno.
Connector	Reservado para uso interno.
ConnectorFormat	Reservado para uso interno.
Creator	Devuelve un entero de 32 bits que indica la aplicación en la que se creó el objeto especificado.
Diagram	Devuelve un Diagram objeto al que pertenece un nodo de diagrama.
DiagramNode	Devuelve un DiagramNode objeto que representa un nodo de un diagrama.
EditID	Representa un objeto en la capa de dibujo, como una autoforma, una forma libre, objeto OLE, control ActiveX o imagen.
Fill	Devuelve un FillFormat objeto que contiene propiedades de formato de relleno para la forma especificada.
Glow	Devuelve un GlowFormat objeto que representa el formato de resplandor de una forma. Solo lectura.
GroupItems	Devuelve un GroupShapes objeto que representa las formas individuales del grupo especificado.
HasChart	True si la forma especificada tiene un gráfico. Solo lectura.
HasDiagram	Determina si una forma es un diagrama.
HasDiagramNode	Determina si una forma es un nodo de diagrama.
HasSmartArt	Obtiene True si hay un diagrama smartart presente en la forma.
Height	Devuelve o establece el alto de la forma especificada en puntos.
HeightRelative	Devuelve o establece un valor Single que representa el porcentaje del alto relativo de una forma. Lectura y escritura.
HorizontalFlip	Indica que una forma se ha volteado horizontalmente.
Hyperlink	Devuelve un Hyperlink objeto que representa el hipervínculo asociado a la forma especificada.
ID	Devuelve el tipo del objeto especificado.
LayoutInCell	Devuelve un entero que representa si una forma de una tabla se muestra dentro de la tabla o fuera de la tabla.
Left	Devuelve o establece un valor Single que representa la posición horizontal, medida en puntos, de la forma especificada o intervalo de formas.
LeftRelative	Devuelve o establece un valor Single que representa la posición izquierda relativa de una forma. Lectura y escritura.
Line	Devuelve un LineFormat objeto que contiene propiedades de formato de línea para la forma especificada.
LinkFormat	Devuelve un LinkFormat objeto que representa las opciones de vínculo de la forma especificada vinculada a un archivo.
LockAnchor	Determina si el delimitador del objeto especificado Shape está bloqueado en el intervalo de anclaje.
LockAspectRatio	Determina si puede cambiar el alto y el ancho de la forma independientemente entre sí al cambiar su tamaño o si conserva sus proporciones originales.
Name	Devuelve o establece el nombre del objeto especificado.
Nodes	Devuelve una ShapeNodes colección que representa la descripción geométrica de la forma especificada.
OLEFormat	Devuelve un OLEFormat objeto que representa las características OLE (distintas de la vinculación) de la forma especificada.
Parent	Devuelve un objeto que representa el objeto primario del objeto especificado.
ParentGroup	Devuelve un Shape objeto que representa la forma primaria común de una forma secundaria.
PictureFormat	Devuelve un PictureFormat objeto que contiene propiedades de formato de imagen para el objeto especificado.
Reflection	Devuelve un ReflectionFormat objeto que representa el formato de reflexión de una forma. Solo lectura.
RelativeHorizontalPosition	Especifica a qué es relativa la posición horizontal de una forma.
RelativeHorizontalSize	Devuelve o establece una WdRelativeHorizontalSize constante que representa el objeto al que es relativo un intervalo de formas. Lectura y escritura.
RelativeVerticalPosition	Especifica a qué es relativa la posición vertical de una forma.
RelativeVerticalSize	Devuelve o establece una WdRelativeVerticalSize constante que representa el tamaño vertical relativo de una forma. Lectura y escritura.
Rotation	Devuelve o establece el número de grados que gira la forma especificada alrededor del eje z.
RTF	Reservado para uso interno.
Script	Devuelve un Script objeto , que representa un bloque de script o código en la página web especificada.
Shadow	Devuelve un ShadowFormat objeto que representa el formato de sombra de la forma especificada.
ShapeStyle	Obtiene o establece el estilo de forma de la forma especificada.
SmartArt	Obtiene un SmartArt objeto que proporciona una manera de trabajar con el SmartArt asociado a la forma especificada.
SoftEdge	Devuelve un SoftEdgeFormat objeto que representa el formato de borde suave de una forma. Solo lectura.
TextEffect	Devuelve un TextEffectFormat objeto que contiene propiedades de formato de efecto de texto para la forma especificada.
TextFrame	Devuelve un TextFrame objeto que contiene el texto de la forma especificada.
TextFrame2	Devuelve un TextFrame2 objeto que contiene el texto de la forma especificada. Solo lectura.
ThreeD	Devuelve un ThreeDFormat objeto que contiene las propiedades de formato del efecto tridimensional de la forma especificada.
Title	Obtiene o establece una cadena que contiene un título para la forma especificada.
Top	Devuelve o establece la posición vertical de la forma especificada en puntos.
TopRelative	Devuelve o establece un valor Single que representa la posición superior relativa de una forma. Lectura y escritura.
Type	Devuelve el tipo de forma.
VerticalFlip	Determina si la forma especificada se voltea alrededor del eje vertical.
Vertices	Devuelve las coordenadas de los vértices del dibujo de forma libre especificado, y los puntos de control de las curvas Bézier, como una serie de pares de coordenadas.
Visible	Determina si el objeto especificado, o el formato que se le aplica, está visible.
Width	Devuelve o establece el ancho del objeto especificado en puntos.
WidthRelative	Devuelve o establece un valor single que representa el ancho relativo de una forma. Lectura y escritura.
WrapFormat	Devuelve un WrapFormat objeto que contiene las propiedades para ajustar el texto alrededor de la forma especificada.
ZOrderPosition	Devuelve la posición de la forma especificada en el orden Z.

Métodos

Activate()	Activa el objeto especificado.
Apply()	Se aplica al formato de forma especificado que se ha copiado mediante el PickUp() método .
CanvasCropBottom(Single)	Recorta un porcentaje del alto de un lienzo de dibujo desde la parte inferior del lienzo.
CanvasCropLeft(Single)	Recorta un porcentaje del ancho de un lienzo de dibujo desde el lado izquierdo del lienzo.
CanvasCropRight(Single)	Recorta un porcentaje del ancho de un lienzo de dibujo desde el lado derecho del lienzo.
CanvasCropTop(Single)	Recorta un porcentaje del alto de un lienzo de dibujo desde la parte superior del lienzo.
ConvertToFrame()	Convierte la forma especificada en un marco.
ConvertToInlineShape()	Convierte la forma especificada en la capa de dibujo de un documento en una forma integrada en la capa de texto.
Delete()	Elimina el objeto especificado.
Duplicate()	Crea un duplicado del objeto especificado Shape , agrega el nuevo intervalo de formas a la Shapes colección en un desplazamiento estándar de las formas originales y, a continuación, devuelve el nuevo objeto Shape .
Flip(MsoFlipCmd)	Voltea una forma horizontal o verticalmente.
IncrementLeft(Single)	Mueve la forma horizontalmente el número de puntos especificado.
IncrementRotation(Single)	Cambia el giro de la forma alrededor del eje Z el número especificado de grados.
IncrementTop(Single)	Mueve la forma verticalmente el número de puntos especificado.
PickUp()	Copia el formato de la forma especificada.
RerouteConnections()	Reservado para uso interno.
ScaleHeight(Single, MsoTriState, MsoScaleFrom)	Cambia el alto de la forma en un factor especificado.
ScaleWidth(Single, MsoTriState, MsoScaleFrom)	Cambia el ancho de la forma en un factor especificado.
Select(Object)	Selecciona el objeto especificado.
SetShapesDefaultProperties()	Aplica el formato de la forma especificada a una forma predeterminada para ese documento. Las nuevas formas heredan muchos de sus atributos de la forma predeterminada.
Ungroup()	Desagrupa las formas agrupadas en la forma especificada.
ZOrder(MsoZOrderCmd)	Mueve la forma especificada delante o detrás de otras formas de la colección (es decir, cambia la posición de la forma en el orden z).