Cómo agregar formas de dibujo a documentos de Word en .NET

Paso 1: Obtén la biblioteca

Clona el repositorio y compila Aspose.Words.sln en configuración Release, luego agrega una referencia de proyecto a Aspose.Words.csproj desde tu propio proyecto .NET, como se describe en el Guía de instalación. Agrega using Aspose.Words; and using Aspose.Words.Drawing; en la parte superior de cualquier archivo que trabaje con formas.

Paso 2: Agrega un AutoShape

Construye una forma directamente con new Shape(doc, shapeType), donde shapeType es un valor ShapeType como Rectangle, Ellipse, Star o TextBox, y luego insértala en el árbol con DocumentBuilder.InsertNode(node). Shape es la clase concreta y sellada que construyes y configuras; deriva de la clase abstracta ShapeBase, que define la posición (Left, Top, Width, Height, Rotation) y los sub-objetos de formato (Fill, Stroke, ShadowFormat, Glow, Reflection) compartidos con GroupShape.

Paso 3: Añadir una imagen

DocumentBuilder.InsertImage es la ruta directa para imágenes: las sobrecargas aceptan un Image, una ruta de archivo, un Stream, o una matriz de bytes cruda, con sobrecargas adicionales que toman width/height explícitos o argumentos de posicionamiento completos (horzPos, left, vertPos, top, width, height, wrapType). La propiedad ImageData del Shape resultante contiene los datos de la imagen — llame a ImageData.SetImage(...) para cambiar la imagen, y use CropTop/CropBottom/CropLeft/CropRight, Brightness, Contrast y GrayScale para ajustes básicos.

Paso 4: Posicionar la forma y ajustar el texto

Una forma en línea (el resultado predeterminado de InsertImage) fluye con el texto circundante e ignora las propiedades de posicionamiento hasta que se flota — verifique IsInline para confirmar en qué modo está la forma. Para flotar una forma, establezca WrapType a un valor no en línea y configure RelativeHorizontalPosition / RelativeVerticalPosition (cada uno relativo a Page, Margin, Column, o un ancla similar) junto con los desplazamientos Left/Top. WrapSide controla el ajuste específico por lado, y HorizontalAlignment / VerticalAlignment manejan la alineación relativa simple en lugar de desplazamientos explícitos.

Paso 5: Rellenar y dar estilo a la forma

Shape.Fill (un objeto Fill) pinta el interior de la forma: Fill.Solid(color) para un color sólido, Fill.OneColorGradient(...) / Fill.TwoColorGradient(...) para degradados, Fill.Patterned(patternType) para un patrón, y Fill.SetImage(...) para un relleno de imagen — FillType indica cuál está actualmente activo. El contorno proviene de la propiedad Stroke. Para efectos, ShadowFormat, Glow (GlowFormat), Reflection (ReflectionFormat) y SoftEdge (SoftEdgeFormat) cada uno expone sus propias configuraciones y un método Remove() que elimina el efecto volviendo a ninguno.

Paso 6: Agrupar varias formas

Combine varias formas en una unidad con DocumentBuilder.InsertGroupShape(shapes), que devuelve un GroupShape. GroupShape es a su vez un ShapeBase, por lo que lleva sus propios Fill, ShadowFormat, Glow y Reflection que se aplican al grupo en su conjunto; mueva o cambie el tamaño del GroupShape en lugar de sus hijos individuales para que la transformación de coordenadas del grupo permanezca coherente. Para una forma que contiene texto, Shape.TextBox (un objeto TextBox) controla el relleno (InternalMarginLeft/Right/Top/Bottom), el ajuste automático de tamaño (FitShapeToText), la dirección del texto (LayoutFlow) y la alineación vertical (VerticalAnchor).

Paso 7: Añadir una marca de agua

Document.Watermark gestiona una única marca de agua a nivel de documento, independiente de cualquier forma que hayas insertado manualmente. Llama a Watermark.SetText(text) o SetText(text, options) para una marca de agua de texto, o a SetImage(...) para una marca de agua de imagen; Watermark.Remove() la elimina, y Watermark.Type informa el WatermarkType actual (Text, Image o None). TextWatermarkOptions establece FontFamily, FontSize, Color y Layout (WatermarkLayout.Horizontal o Diagonal); ImageWatermarkOptions establece Scale y IsWashout.