Lucrul cu filigrane

Acest ghid arată cum să adăugați, să configurați și să eliminați filigranele documentului în Aspose.Words FOSS pentru .NET folosind Watermark clasa, accesată prin Document.Watermark. Un filigran poate fi text sau o imagine, și doar un filigran este activ pe un document la un moment dat – setarea unuia nou înlocuiește orice era acolo înainte.

Adăugarea unui filigran text

Watermark.SetText(text) adaugă un filigran text cu formatare implicită. Supraincarcarea SetText(text, options) primește o instanță TextWatermarkOptions pentru a controla aspectul său: FontFamily, Color și FontSize controlează formatarea textului, IsSemitrasparent activează/dezactivează efectul semi-transparent tipic al filigranelor, iar Layout (o valoare WatermarkLayout — Horizontal sau Diagonal) controlează orientarea față de pagină.

Adăugarea unui filigran imagine

Watermark.SetImage(image) adaugă un filigran imagine dintr-un Image deja încărcat. Supraincarcările care primesc, de asemenea, o instanță ImageWatermarkOptions — SetImage(image, options), SetImage(imagePath, options) (încărcare dintr-o cale de fișier) și SetImage(imageStream, options) (încărcare dintr-un Stream) — vă permit să controlați Scale (factorul de scară al imaginii, exprimat ca fracție) și IsWashout (efectul de decolorare care împiedică o imagine filigran să copleșească conținutul paginii).

Verificarea și eliminarea unui filigran

Watermark.Type raportează tipul actual al filigranei ca o valoare WatermarkType – Text, Image sau None dacă nu este setată nicio filigrană. Apelați Watermark.Remove() pentru a elimina filigrana curentă din document.

Sfaturi și cele mai bune practici

Verificați Watermark.Type înainte de a presupune că există o filigrană – returnează WatermarkType.None pe un document care nu a avut niciodată una setată.
Setarea unei noi filigrane prin SetText() sau SetImage() înlocuiește orice filigran existent; nu există nicio modalitate de a avea mai mult de o filigrană activă simultan.
Utilizați WatermarkLayout.Diagonal pentru a reproduce orientarea diagonală implicită a filigranei în Word, sau Horizontal pentru o filigrană care rulează paralel cu marginile paginii.
Preferați suprascrierile ImageWatermarkOptions/TextWatermarkOptions în locul apelurilor simple SetImage(image) / SetText(text) ori de câte ori aveți nevoie să controlați opacitatea, scala sau fontul – suprascrierile fără parametri folosesc valorile implicite ale Word.

Probleme comune

Problemă	Cauză	Remediere
Un nou filigran nu apare alături de cel vechi	`SetText()`/`SetImage()` înlocuiește filigranul existent în loc să adauge unul al doilea	Apelă `Remove()` mai întâi doar dacă trebuie să îl ștergi înainte de a seta un alt tip; în caz contrar, înlocuirea este automată
Un filigran de tip imagine copleșește conținutul paginii	`ImageWatermarkOptions.IsWashout` a rămas dezactivat	Setează `IsWashout` la `true` când construiești `ImageWatermarkOptions`
Fontul filigranului de text nu corespunde tipului de caractere dorit	`TextWatermarkOptions.FontFamily` nu a fost setat (sau a fost scris greșit)	Setaţi `FontFamily` la un nume de font disponibil în mediul de redare

FAQ

Cum pot verifica dacă un document are deja un filigran?

Citește Document.Watermark.Type; returnează WatermarkType.Text, WatermarkType.Image sau WatermarkType.None.

Cum pot elimina un filigran?

Apelează Document.Watermark.Remove().

Pot controla transparența filigranului?

Da – pentru filigrane text, setează TextWatermarkOptions.IsSemitrasparent; pentru filigrane imagine, setează ImageWatermarkOptions.IsWashout.

Cum pot încărca un filigran imagine de pe disc în loc de un `Image` în memorie?

Folosește suprascrierea Watermark.SetImage(imagePath, options), trecând calea fișierului ca șir de caractere împreună cu o instanță ImageWatermarkOptions.

API Reference Rezumat

Clasă / Enum	Descriere:
`Watermark`	Filigran de document, prin `Document.Watermark`; `SetText()`, `SetImage()`, `Remove()`, `Type`
`WatermarkType`	Enum care identifică tipul curent de filigran: `Text`, `Image`, `None`
`WatermarkLayout`	Enum pentru orientarea filigranului: `Horizontal`, `Diagonal`
`TextWatermarkOptions`	Formatare filigran text: `FontFamily`, `Color`, `FontSize`, `IsSemitrasparent`, `Layout`
`ImageWatermarkOptions`	Opțiuni filigran imagine: `Scale`, `IsWashout`

Vezi și:

Aspose.Words for .NET — Enterprise Documentation

Lucrul cu filigrane