Práce s vodoznaky

Tento průvodce ukazuje, jak přidávat, konfigurovat a odstraňovat vodoznaky dokumentů v Aspose.Words FOSS pro .NET použitím Watermark třídy, dosažené přes Document.Watermark. Vodoznak může být text nebo obrázek a na dokumentu může být v danou chvíli aktivní pouze jeden vodoznak – nastavení nového nahradí ten předchozí.

Přidání textového vodoznaku

Watermark.SetText(text) přidává textový vodoznak s výchozím formátováním. Přetížení SetText(text, options) přijímá instanci TextWatermarkOptions pro řízení jejího vzhledu: FontFamily, Color a FontSize řídí formátování textu, IsSemitrasparent přepíná poloprůhledný efekt typický pro vodoznaky a Layout (hodnota WatermarkLayout – Horizontal nebo Diagonal) určuje její orientaci vzhledem k stránce.

Přidání obrázkového vodoznaku

Watermark.SetImage(image) přidává obrázkový vodoznak z již načteného Image. Přetížení, která také přijímají instanci ImageWatermarkOptions – SetImage(image, options), SetImage(imagePath, options) (načítání ze souborové cesty) a SetImage(imageStream, options) (načítání z Stream) – vám umožňují řídit Scale (škálovací faktor obrázku vyjádřený jako zlomek) a IsWashout (vybledlý efekt, který zabraňuje, aby obrázek vodoznaku převládl nad obsahem stránky).

Kontrola a odstraňování vodoznaku

Watermark.Type hlásí aktuální typ vodoznaku jako WatermarkType hodnotu – Text, Image nebo None pokud není žádný vodoznak nastaven. Zavolejte Watermark.Remove() pro odstranění aktuálního vodoznaku z dokumentu.

Tipy a osvědčené postupy

Zkontrolujte Watermark.Type před tím, než předpokládáte, že vodoznak existuje – vrací WatermarkType.None u dokumentu, který nikdy neměl vodoznak nastaven.
Nastavení nového vodoznaku pomocí SetText() nebo SetImage() nahradí jakýkoli existující vodoznak; není možné mít najednou více než jeden aktivní vodoznak.
Použijte WatermarkLayout.Diagonal k reprodukci výchozí diagonální orientace vodoznaku ve Wordu, nebo Horizontal pro vodoznak, který běží paralelně s okraji stránky.
Upřednostňujte přetížení ImageWatermarkOptions/TextWatermarkOptions před jednoduchými voláními SetImage(image) / SetText(text), kdykoli potřebujete řídit neprůhlednost, měřítko nebo písmo – přetížení bez parametrů používají výchozí hodnoty Wordu.

Časté problémy

Problém	Příčina	Oprava
Nový vodoznak se nezobrazuje vedle starého	`SetText()`/`SetImage()` nahrazuje existující vodoznak místo přidání druhého	Zavolejte `Remove()` nejprve jen pokud potřebujete jej vymazat před nastavením jiného typu; jinak je náhrada automatická
Obrázkový vodoznak přehlušuje obsah stránky	`ImageWatermarkOptions.IsWashout` byl ponechán vypnutý	Nastavte `IsWashout` na `true` při vytváření `ImageWatermarkOptions`
Písmo textového vodoznaku neodpovídá zamýšlenému fontu	`TextWatermarkOptions.FontFamily` nebyl nastaven (nebo byl špatně napsán)	Nastavte `FontFamily` na název písma dostupný v renderovacím prostředí

FAQ

Jak zjistím, zda dokument již obsahuje vodoznak?

Přečtěte Document.Watermark.Type; vrátí WatermarkType.Text, WatermarkType.Image nebo WatermarkType.None.

Jak mohu odstranit vodoznak?

Zavolejte Document.Watermark.Remove().

Mohu ovládat průhlednost vodoznaku?

Ano – pro textové vodoznaky nastavte TextWatermarkOptions.IsSemitrasparent; pro obrázkové vodoznaky nastavte ImageWatermarkOptions.IsWashout.

Jak načíst obrázkový vodoznak z disku místo `Image` ve v paměti?

Použijte přetížení Watermark.SetImage(imagePath, options), předáním cesty k souboru jako řetězce spolu s instancí ImageWatermarkOptions.

API Reference Shrnutí

Třída / Výčet	Popis:
`Watermark`	Vodoznak dokumentu, přes `Document.Watermark`; `SetText()`, `SetImage()`, `Remove()`, `Type`
`WatermarkType`	Výčtový typ (enum) identifikující aktuální typ vodoznaku: `Text`, `Image`, `None`
`WatermarkLayout`	Výčtový typ (enum) pro orientaci vodoznaku: `Horizontal`, `Diagonal`
`TextWatermarkOptions`	Formátování textového vodoznaku: `FontFamily`, `Color`, `FontSize`, `IsSemitrasparent`, `Layout`
`ImageWatermarkOptions`	Možnosti obrázkového vodoznaku: `Scale`, `IsWashout`

Viz také:

Aspose.Words for .NET — Enterprise Documentation

Práce s vodoznaky