ApplyWatermark
Seitenlayout
Beschreibung
Wendet eine kombinierbare Wasserzeichenvorlage auf das ausgewählte Dokument an. Die Vorlage ist eine Instanz von TPDFlibWatermarkBase (aus der Unit PDFlibWatermark) und kann ein Textwasserzeichen, ein Bildwasserzeichen, ein Wasserzeichen aus einer Vektorform oder ein Verbund sein, der eine Liste rekursiv angewendeter Unterwasserzeichen enthält.
Jedes Template hat seine eigene Position (einer von neun Ankerpunkten oder wpCustom), einen Winkel (Angle), eine Deckkraft (Opacity, 0..1), einen Overlay-Modus (soOverlay zeichnet über vorhandenem Inhalt, soUnderlay zeichnet darunter) und eine PageRange; bei zusammengesetzten Wasserzeichen erben untergeordnete Elemente mit leerer PageRange den Bereich des übergeordneten Elements
Intern delegiert das Wasserzeichen an StampText / StampImage, sodass Deckkraft, Rotation, Ebenenreihenfolge und Seitenbereichsauflösung über denselben bewährten Pfad wie die Stempel-APIs verarbeitet werden
Syntax
Delphi
Function TPDFlib.ApplyWatermark(Watermark: TPDFlibWatermarkBase): Integer;Parameter
| Watermark | Eine Wasserzeichenvorlageninstanz (TPDFlibTextWatermark, TPDFlibImageWatermark oder TPDFlibCompositeWatermark). Der Aufrufer besitzt das Objekt und muss es nach dem Aufruf freigeben |
|---|
Rückgabewerte
| 0 | Es wurde kein Wasserzeichen platziert (kein Dokument geladen, nil Wasserzeichen oder leerer Text/leeres Bild) |
|---|---|
| >= 1 | Die Anzahl der Seiten, auf denen das Wasserzeichen platziert wurde |