Arbeta med vattenstämplar

Denna guide visar hur man lägger till, konfigurerar och tar bort dokumentvattenstämplar i Aspose.Words FOSS för .NET med hjälp av Watermark klass, nås via Document.Watermark. En vattenstämpel kan vara text eller en bild, och endast en vattenstämpel är aktiv på ett dokument åt gången – att ställa in en ny ersätter den som fanns där tidigare.

Lägga till en textvattenstämpel

Watermark.SetText(text) lägger till en textvattenstämpel med standardformatering. SetText(text, options)-överladdningen tar en TextWatermarkOptions-instans för att styra dess utseende: FontFamily, Color och FontSize kontrollerar textformateringen, IsSemitrasparent växlar den halvgenomskinliga effekten som är typisk för vattenstämplar, och Layout (ett WatermarkLayout-värde – Horizontal eller Diagonal) styr dess orientering i förhållande till sidan.

Lägga till en bildvattenstämpel

Watermark.SetImage(image) lägger till en bildvattenstämpel från en redan inläst Image. Överladdningar som också tar en ImageWatermarkOptions-instans – SetImage(image, options), SetImage(imagePath, options) (laddar från en filsökväg) och SetImage(imageStream, options) (laddar från en Stream) – låter dig styra Scale (bildens skalningsfaktor, uttryckt som en bråkdel) och IsWashout (den urtvättade effekten som förhindrar att en vattenstämpelbild dominerar sidans innehåll).

Kontrollera och ta bort en vattenstämpel

Watermark.Type rapporterar den aktuella vattenstämpelns typ som ett WatermarkType värde – Text, Image eller None om ingen vattenstämpel är inställd. Anropa Watermark.Remove() för att ta bort den aktuella vattenstämpeln från dokumentet.

Tips och bästa praxis

Kontrollera Watermark.Type innan du antar att en vattenstämpel finns – den returnerar WatermarkType.None på ett dokument som aldrig har haft någon inställd.
Att sätta en ny vattenstämpel via SetText() eller SetImage() ersätter eventuell befintlig vattenstämpel; det går inte att ha mer än en aktiv vattenstämpel åt gången.
Använd WatermarkLayout.Diagonal för att återge Words standard diagonala vattenstämpelorientering, eller Horizontal för en vattenstämpel som löper parallellt med sidans kanter.
Föredra ImageWatermarkOptions/TextWatermarkOptions-överladdningarna framför de enkla SetImage(image) / SetText(text)-anropen när du behöver kontrollera opacitet, skala eller typsnitt – de parametrarfria överladdningarna använder Words standardinställningar.

Vanliga problem

Problem	Orsak	Åtgärd
En ny vattenstämpel visas inte bredvid den gamla	`SetText()`/`SetImage()` ersätter den befintliga vattenstämpeln istället för att lägga till en andra	Anropa `Remove()` först endast om du behöver rensa den innan du ställer in en annan typ; annars sker ersättningen automatiskt
En bildvattenstämpel överskuggar sidans innehåll	`ImageWatermarkOptions.IsWashout` lämnades inaktiverad	Ställ in `IsWashout` till `true` när du konstruerar `ImageWatermarkOptions`
Textvattenstämpelns teckensnitt matchar inte det avsedda typsnittet	`TextWatermarkOptions.FontFamily` var inte inställd (eller felstavad)	Ställ in `FontFamily` till ett typsnittsnamn som är tillgängligt i renderingsmiljön

FAQ

Hur kontrollerar jag om ett dokument redan har ett vattenstämpel?

Läs Document.Watermark.Type; den returnerar WatermarkType.Text, WatermarkType.Image eller WatermarkType.None.

Hur tar jag bort en vattenstämpel?

Anropa Document.Watermark.Remove().

Kan jag styra vattenstämpelns transparens?

Ja – för textvattenstämplar, ange TextWatermarkOptions.IsSemitrasparent; för bildvattenstämplar, ange ImageWatermarkOptions.IsWashout.

Hur laddar jag ett bildvattenstämpel från disk istället för ett in-memory `Image`?

Använd Watermark.SetImage(imagePath, options)-överladdningen, skicka filvägen som en sträng tillsammans med en ImageWatermarkOptions-instans.

API Reference Sammanfattning

Klass / Enum	Beskrivning
`Watermark`	Dokumentvattenstämpel, via `Document.Watermark`; `SetText()`, `SetImage()`, `Remove()`, `Type`
`WatermarkType`	Enum som identifierar den aktuella vattenstämpeltypen: `Text`, `Image`, `None`
`WatermarkLayout`	Enum för vattenstämpelns orientering: `Horizontal`, `Diagonal`
`TextWatermarkOptions`	Formatering av textvattenstämpel: `FontFamily`, `Color`, `FontSize`, `IsSemitrasparent`, `Layout`
`ImageWatermarkOptions`	Alternativ för bildvattenstämpel: `Scale`, `IsWashout`

Se även

Aspose.Words for .NET — Enterprise Documentation

Arbeta med vattenstämplar