Hoe tekenvormen toevoegen aan Word-documenten in .NET

Stap 1: Haal de bibliotheek op

Kloon de repository en bouw Aspose.Words.sln in Release-configuratie, voeg vervolgens een projectreferentie toe aan Aspose.Words.csproj vanuit je eigen .NET-project, zoals beschreven in de Installatiehandleiding. Voeg toe using Aspose.Words; and using Aspose.Words.Drawing; aan de bovenkant van elk bestand dat met vormen werkt.

Stap 2: Voeg een AutoShape toe

Bouw een vorm direct met new Shape(doc, shapeType), waarbij shapeType een ShapeType waarde is, zoals Rectangle, Ellipse, Star of TextBox, en voeg deze vervolgens in de boom in met DocumentBuilder.InsertNode(node). Shape is de concrete, sealed class die je maakt en configureert; hij is afgeleid van de abstracte ShapeBase, die positie definieert (Left, Top, Width, Height, Rotation) en opmaak-subobjecten (Fill, Stroke, ShadowFormat, Glow, Reflection) die gedeeld worden met GroupShape.

Stap 3: Voeg een afbeelding toe

DocumentBuilder.InsertImage is de directe route voor afbeeldingen: overloads accepteren een Image, een bestandspad, een Stream, of een ruwe byte-array, met extra overloads die expliciete width/height of volledige positioneringsargumenten (horzPos, left, vertPos, top, width, height, wrapType) nemen. De ImageData eigenschap van het resulterende Shape bevat de afbeeldingsgegevens — roep ImageData.SetImage(...) aan om de afbeelding te vervangen, en gebruik CropTop/CropBottom/CropLeft/CropRight, Brightness, Contrast, en GrayScale voor basisaanpassingen.

Stap 4: Positioneer de vorm en omsluit tekst

Een inline vorm (het standaardresultaat van InsertImage) stroomt mee met de omringende tekst en negeert positioneringseigenschappen totdat deze zweeft — controleer IsInline om te bevestigen in welke modus een vorm zich bevindt. Om een vorm te laten zweven, stel WrapType in op een niet-inline waarde en stel RelativeHorizontalPosition / RelativeVerticalPosition in (elk relatief ten opzichte van Page, Margin, Column, of een vergelijkbare anker) samen met de Left/Top offsets. WrapSide regelt zijde-specifieke omsluiting, en HorizontalAlignment / VerticalAlignment behandelen eenvoudige relatieve uitlijning in plaats van expliciete offsets.

Stap 5: Vul en style de vorm

Shape.Fill (een Fill object) schildert het binnenste van de vorm: Fill.Solid(color) voor een effen kleur, Fill.OneColorGradient(...) / Fill.TwoColorGradient(...) voor verlopen, Fill.Patterned(patternType) voor een patroon, en Fill.SetImage(...) voor een afbeeldingvulling — FillType meldt welke momenteel actief is. De omtrek komt van de Stroke eigenschap. Voor effecten bieden ShadowFormat, Glow (GlowFormat), Reflection (ReflectionFormat) en SoftEdge (SoftEdgeFormat) elk hun eigen instellingen en een Remove() methode die het effect terugzet naar geen.

Stap 6: Groepeer meerdere vormen

Combineer verschillende vormen tot één eenheid met DocumentBuilder.InsertGroupShape(shapes), die een GroupShape retourneert. GroupShape is zelf een ShapeBase, dus draagt het zijn eigen Fill, ShadowFormat, Glow en Reflection die op de groep als geheel van toepassing zijn; verplaats of wijzig de grootte van de GroupShape in plaats van de individuele kinderen zodat de coördinatentransformatie van de groep consistent blijft. Voor een vorm die tekst bevat, regelt Shape.TextBox (een TextBox object) de opvulling (InternalMarginLeft/Right/Top/Bottom), automatische grootte-aanpassing (FitShapeToText), tekstrichting (LayoutFlow) en verticale uitlijning (VerticalAnchor).

Stap 7: Voeg een watermerk toe

Document.Watermark beheert een enkel documentbreed watermerk onafhankelijk van enige vorm die je handmatig hebt ingevoegd. Roep Watermark.SetText(text) of SetText(text, options) aan voor een tekstwatermerk, of SetImage(...) voor een afbeeldingwatermerk; Watermark.Remove() wist het, en Watermark.Type rapporteert de huidige WatermarkType (Text, Image, of None). TextWatermarkOptions stelt FontFamily, FontSize, Color, en Layout (WatermarkLayout.Horizontal of Diagonal) in; ImageWatermarkOptions stelt Scale en IsWashout in.