ApplyWatermark

Układ strony

Opis

Stosuje możliwy do komponowania szablon znaku wodnego do wybranego dokumentu. Szablon jest instancją TPDFlibWatermarkBase (z modułu PDFlibWatermark) i może być tekstowym znakiem wodnym, obrazowym znakiem wodnym, wektorowym znakiem wodnym albo kompozytem zawierającym listę podznaków wodnych stosowanych rekurencyjnie.

TPDFlibShapeWatermark umieszcza prostokąt, okrąg, elipsę, wielokąt, łańcuch krzywych Beziera lub linię prostą z kolorami wypełnienia i obrysu, szerokością linii oraz kryciem. Prostokąty, okręgi i elipsy określają rozmiar na podstawie Width/Height; wielokąty, krzywe i linie pobierają geometrię z SetPoints (pary X,Y opisane jako 'lokalne’ względem lewego górnego narożnika kształtu), dzięki czemu dziewięciopunktowa siatka Position ma zastosowanie do każdego rodzaju kształtu.

Każdy szablon ma własne Position (jeden z dziewięciu punktów kotwiczenia lub wpCustom), Angle, Opacity (0..1), tryb Overlay (soOverlay rysuje nad istniejącą zawartością, soUnderlay pod nią) oraz PageRange. W przypadku złożonych znaków wodnych elementy podrzędne z pustym PageRange dziedziczą zakres kompozytu.

Wewnętrznie znak wodny deleguje do StampText / StampImage, dlatego krycie, obrót, kolejność warstw i rozwiązywanie zakresu stron są obsługiwane przez tę samą sprawdzoną ścieżkę co interfejsy API stemplowania.

Składnia

Delphi

Function TPDFlib.ApplyWatermark(Watermark: TPDFlibWatermarkBase): Integer;

Parametry

Watermark	Instancja szablonu znaku wodnego (TPDFlibTextWatermark, TPDFlibImageWatermark lub TPDFlibCompositeWatermark). Obiekt należy do wywołującego i musi zostać przez niego zwolniony po wywołaniu

Wartości zwracane

0	Nie umieszczono znaku wodnego (brak wczytanego dokumentu, znak wodny nil albo pusty tekst/obraz)
>= 1	Liczba stron, na których umieszczono znak wodny