Shapes Interfaz

Definición

Espacio de nombres:

Microsoft.Office.Interop.Word

Ensamblado:

Microsoft.Office.Interop.Word.dll

Colección de Shape 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.

public interface class Shapes : System::Collections::IEnumerable

[System.Runtime.InteropServices.Guid("0002099F-0000-0000-C000-000000000046")]
public interface Shapes : System.Collections.IEnumerable

type Shapes = interface
    interface IEnumerable

Public Interface Shapes
Implements IEnumerable

Atributos

GuidAttribute

Implementaciones

IEnumerable

Comentarios

Cada objeto Shape representa un objeto en la capa de dibujo, como una autoforma, una forma libre, un objeto OLE o una imagen.

Nota Si desea trabajar con un subconjunto de las formas de un documento, por ejemplo, para hacer algo solo con las Autoformas del documento o solo con las formas seleccionadas, debe construir una ShapeRange colección que contenga las formas con las que desea trabajar.

Use la Shapes propiedad para devolver la colección Shapes .

Nota Si desea hacer algo (como eliminar o establecer una propiedad) en todas las formas de un documento al mismo tiempo, use el Range(Object) método para crear un objeto ShapeRange que contenga todas las formas de la colección Shapes y, a continuación, aplique la propiedad o el método adecuados al objeto ShapeRange .

Use uno de los métodos siguientes de la colección Shapes : 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) para agregar una forma a un documento y devolver un objeto Shape que represente la forma recién creada.

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

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 .

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. Puede usar el ConvertToInlineShape() método y el ConvertToShape(Object) 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.

La Count propiedad de esta colección de un documento devuelve solo el número de elementos del artículo principal. Para contar las formas en todos los encabezados y pies de página, use la colección Shapes con cualquier HeaderFooter objeto.

Propiedades

Application	Devuelve un Application objeto que representa la aplicación microsoft Word.
Count	Devuelve el número de elementos de la colección especificada.
Creator	Devuelve un entero de 32 bits que indica la aplicación en la que se creó el objeto especificado.
Item[Object]	Devuelve un objeto individual de una colección.
Parent	Devuelve un objeto que representa el objeto primario del objeto especificado.

Métodos

AddCallout(MsoCalloutType, Single, Single, Single, Single, Object)	Agrega una llamada de línea sin borde a un documento. Devuelve un Shape objeto que representa la llamada y la agrega a la Shapes colección.
AddCanvas(Single, Single, Single, Single, Object)	Agrega un lienzo de dibujo a un documento. Devuelve un Shape objeto que representa el lienzo de dibujo y lo agrega a la Shapes colección.
AddChart(XlChartType, Object, Object, Object, Object, Object)	Este objeto, miembro o enumeración está en desuso y no debería usarse en el código.
AddChart2(Int32, XlChartType, Object, Object, Object, Object, Object, Object)	Agrega un gráfico al documento. Devuelve un Shape objeto que representa un gráfico y lo agrega a la colección especificada.
AddConnector(MsoConnectorType, Single, Single, Single, Single)	Reservado para uso interno.
AddCurve(Object, Object)	Devuelve un Shape objeto que representa una curva bézier en un documento.
AddDiagram(MsoDiagramType, Single, Single, Single, Single, Object)	Devuelve un Shape objeto que representa un diagrama recién creado en un documento.
AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object)	Agrega una etiqueta de texto a un documento. Devuelve un Shape objeto que representa la etiqueta de texto y la agrega a la Shapes colección.
AddLine(Single, Single, Single, Single, Object)	Agrega una línea a un documento. Devuelve un Shape objeto que representa la línea y lo agrega a la AddCallout(MsoCalloutType, Single, Single, Single, Single, Object) colección.
AddOLEControl(Object, Object, Object, Object, Object, Object)	Crea un control ActiveX (anteriormente denominado control OLE). Devuelve el Shape objeto que representa el nuevo control ActiveX.
AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Crea un objeto OLE. Devuelve el Shape objeto que representa el nuevo objeto OLE.
AddPicture(String, Object, Object, Object, Object, Object, Object, Object)	Agrega una imagen a un documento. Devuelve un Shape objeto que representa la imagen y la agrega a la Shapes colección.
AddPolyline(Object, Object)	Agrega un polígono abierto o cerrado a un documento. Devuelve un Shape objeto que representa el polígono y lo agrega a la Shapes colección.
AddShape(Int32, Single, Single, Single, Single, Object)	Agrega una autoforma a un documento. Devuelve un Shape objeto que representa la autoforma y lo agrega a la Shapes colección.
AddSmartArt(SmartArtLayout, Object, Object, Object, Object, Object)	Inserta el elemento gráfico SmartArt especificado en el documento activo.
AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object)	Agrega un cuadro de texto a un documento. Devuelve un Shape objeto que representa el cuadro de texto y lo agrega a la Shapes colección.
AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object)	Agrega una forma de WordArt a un documento. Devuelve un Shape objeto que representa wordart y lo agrega a la Shapes colección.
AddWebVideo(String, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Agrega un nuevo vídeo web al documento.
BuildFreeform(MsoEditingType, Single, Single)	Genera un objeto de forma libre. Devuelve un FreeformBuilder objeto que representa la forma libre mientras se está compilando.
GetEnumerator()	Colección de Shape 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.
Range(Object)	Devuelve un ShapeRange objeto .
SelectAll()	Selecciona todas las formas del artículo principal, en un lienzo o en encabezados y pies de página de un documento.