Compartir a través de


Shape Interfaz

Definición

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

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).

Se aplica a