Werken met watermerken

Werken met watermerken

Deze gids laat zien hoe je documentwatermerken kunt toevoegen, configureren en verwijderen in Aspose.Words FOSS voor .NET met behulp van de Watermark klasse, bereikt via Document.Watermark. Een watermerk kan tekst of een afbeelding zijn, en er is slechts één watermerk actief op een document tegelijk – het instellen van een nieuw watermerk vervangt wat er eerder stond.


Een tekstwatermerk toevoegen

Watermark.SetText(text) voegt een tekstwatermerk toe met standaardopmaak. De SetText(text, options) overload neemt een TextWatermarkOptions instantie om het uiterlijk te regelen: FontFamily, Color en FontSize regelen de tekstopmaak, IsSemitrasparent schakelt het halftransparante effect in dat typisch is voor watermerken, en Layout (een WatermarkLayout waarde - Horizontal of Diagonal) bepaalt de oriëntatie ten opzichte van de pagina.


Een afbeeldingwatermerk toevoegen

Watermark.SetImage(image) voegt een afbeeldingwatermerk toe vanuit een reeds geladen Image. Overloads die ook een ImageWatermarkOptions instantie nemen – SetImage(image, options), SetImage(imagePath, options) (laden vanaf een bestandspad), en SetImage(imageStream, options) (laden vanaf een Stream) – laten je Scale (de schaalfactor van de afbeelding, uitgedrukt als een breuk) en IsWashout (het vervaagde effect dat voorkomt dat een watermerkafbeelding de paginainhoud overweldigt) regelen.


Controleren en verwijderen van een watermerk

Watermark.Type rapporteert het huidige type watermerk als een WatermarkType waarde – Text, Image, of None als er geen watermerk is ingesteld. Roep Watermark.Remove() aan om het huidige watermerk uit het document te verwijderen.


Tips en best practices

  • Controleer Watermark.Type voordat u aanneemt dat er een watermerk bestaat – het retourneert WatermarkType.None op een document dat nog nooit een watermerk heeft gehad.
  • Het instellen van een nieuw watermerk via SetText() of SetImage() vervangt elk bestaand watermerk; er is geen manier om meer dan één actief watermerk tegelijk te hebben.
  • Gebruik WatermarkLayout.Diagonal om de standaard diagonale oriëntatie van een watermerk in Word te reproduceren, of Horizontal voor een watermerk dat parallel aan de paginaranden loopt.
  • Geef de voorkeur aan de ImageWatermarkOptions/TextWatermarkOptions overloads boven de eenvoudige SetImage(image) / SetText(text) aanroepen wanneer u de doorzichtigheid, schaal of het lettertype moet regelen – de overloads zonder parameters gebruiken de standaardinstellingen van Word.

Veelvoorkomende problemen

ProbleemOorzaakOplossing
Een nieuw watermerk wordt niet naast het oude weergegevenSetText()/SetImage() vervangt het bestaande watermerk in plaats van een tweede toe te voegenRoep Remove() eerst alleen aan als je het moet wissen voordat je een ander type instelt; anders is de vervanging automatisch
Een afbeelding-watermerk overschaduwt de paginainhoudImageWatermarkOptions.IsWashout was uitgeschakeld gelatenStel IsWashout in op true bij het bouwen van de ImageWatermarkOptions
Lettertype van tekst-watermerk komt niet overeen met het beoogde lettertypeTextWatermarkOptions.FontFamily was niet ingesteld (of verkeerd gespeld)Stel FontFamily in op een lettertype-naam die beschikbaar is in de renderomgeving

FAQ

Hoe controleer ik of een document al een watermerk heeft?

Lees Document.Watermark.Type; het retourneert WatermarkType.Text, WatermarkType.Image of WatermarkType.None.

Hoe verwijder ik een watermerk?

Roep Document.Watermark.Remove() aan.

Kan ik de transparantie van het watermerk regelen?

Ja – voor tekstwatermerken, stel TextWatermarkOptions.IsSemitrasparent in; voor afbeeldingwatermerken, stel ImageWatermarkOptions.IsWashout in.

Hoe laad ik een afbeeldingwatermerk vanaf schijf in plaats van een in-memory Image?

Gebruik de Watermark.SetImage(imagePath, options) overload, waarbij je het bestandspad als string meegeeft samen met een ImageWatermarkOptions instantie.


API Reference Samenvatting

Klasse / EnumBeschrijving
WatermarkDocumentwatermerk, via Document.Watermark; SetText(), SetImage(), Remove(), Type
WatermarkTypeEnum die het huidige watermerktype identificeert: Text, Image, None
WatermarkLayoutEnum voor watermerkoriëntatie: Horizontal, Diagonal
TextWatermarkOptionsTekstwatermerk opmaak: FontFamily, Color, FontSize, IsSemitrasparent, Layout
ImageWatermarkOptionsAfbeeldingswatermerk opties: Scale, IsWashout

Zie ook

 Nederlands