Come aggiungere forme di disegno ai documenti Word in .NET

Passo 1: Ottieni la libreria

Clona il repository e compila Aspose.Words.sln in configurazione Release, quindi aggiungi un riferimento al progetto a Aspose.Words.csproj dal tuo progetto .NET personale, come descritto nel Guida all’installazione. Aggiungi using Aspose.Words; and using Aspose.Words.Drawing; all’inizio di qualsiasi file che lavora con le forme.

Passo 2: Aggiungi un AutoShape

Costruisci una forma direttamente con new Shape(doc, shapeType), dove shapeType è un valore ShapeType come Rectangle, Ellipse, Star o TextBox, quindi inseriscila nell’albero con DocumentBuilder.InsertNode(node). Shape è la classe concreta e sealed che costruisci e configuri; deriva dalla classe abstract ShapeBase, che definisce la posizione (Left, Top, Width, Height, Rotation) e gli oggetti di formattazione secondari (Fill, Stroke, ShadowFormat, Glow, Reflection) condivisi con GroupShape.

Passo 3: Aggiungi un’immagine

DocumentBuilder.InsertImage è il percorso diretto per le immagini: le overload accettano un Image, un percorso file, un Stream, o un array di byte grezzo, con ulteriori overload che prendono espliciti width/height o argomenti di posizionamento completi (horzPos, left, vertPos, top, width, height, wrapType). Il Shape risultante ha la proprietà ImageData che contiene i dati dell’immagine — chiama ImageData.SetImage(...) per sostituire l’immagine, e usa CropTop/CropBottom/CropLeft/CropRight, Brightness, Contrast, e GrayScale per aggiustamenti di base.

Passo 4: Posiziona la forma e avvolgi il testo

Una forma in linea (il risultato predefinito di InsertImage) fluisce con il testo circostante e ignora le proprietà di posizionamento finché non galleggia — controlla IsInline per confermare in quale modalità si trovi una forma. Per far galleggiare una forma, imposta WrapType su un valore non in linea e imposta RelativeHorizontalPosition / RelativeVerticalPosition (ognuno relativo a Page, Margin, Column, o a un ancoraggio simile) insieme agli offset Left/Top. WrapSide controlla l’avvolgimento specifico per lato, e HorizontalAlignment / VerticalAlignment gestiscono l’allineamento relativo semplice invece degli offset espliciti.

Passo 5: Riempire e stilizzare la forma

Shape.Fill (un oggetto Fill) dipinge l’interno della forma: Fill.Solid(color) per un colore piatto, Fill.OneColorGradient(...) / Fill.TwoColorGradient(...) per gradienti, Fill.Patterned(patternType) per un motivo, e Fill.SetImage(...) per un riempimento immagine — FillType indica quale è attualmente attivo. Il contorno proviene dalla proprietà Stroke. Per gli effetti, ShadowFormat, Glow (GlowFormat), Reflection (ReflectionFormat), e SoftEdge (SoftEdgeFormat) espongono ciascuno le proprie impostazioni e un metodo Remove() che cancella l’effetto riportandolo a nessuno.

Passo 6: Raggruppa più forme

Combina diverse forme in un’unica unità con DocumentBuilder.InsertGroupShape(shapes), che restituisce un GroupShape. GroupShape è esso stesso un ShapeBase, quindi porta i propri Fill, ShadowFormat, Glow, e Reflection che si applicano all’intero gruppo; sposta o ridimensiona il GroupShape invece dei suoi singoli figli così la trasformazione delle coordinate del gruppo rimane coerente. Per una forma che contiene testo, Shape.TextBox (un oggetto TextBox) controlla il padding (InternalMarginLeft/Right/Top/Bottom), il dimensionamento automatico (FitShapeToText), la direzione del testo (LayoutFlow), e l’allineamento verticale (VerticalAnchor).

Passo 7: Aggiungi una filigrana

Document.Watermark gestisce una singola filigrana a livello di documento indipendente da qualsiasi forma inserita manualmente. Chiama Watermark.SetText(text) o SetText(text, options) per una filigrana di testo, o SetImage(...) per una filigrana immagine; Watermark.Remove() la rimuove, e Watermark.Type restituisce l’attuale WatermarkType (Text, Image, o None). TextWatermarkOptions imposta FontFamily, FontSize, Color, e Layout (WatermarkLayout.Horizontal o Diagonal); ImageWatermarkOptions imposta Scale e IsWashout.