ApplyWatermark

頁面版面

描述

將可組合的浮水印範本套用至所選文件。範本是 TPDFlibWatermarkBase 的執行個體(來自 PDFlibWatermark 單元),可以是文字浮水印、影像浮水印、向量形狀浮水印,或遞迴套用一串子浮水印的複合浮水印。

TPDFlibShapeWatermark 蓋印矩形、圓形、橢圓、多邊形、Bezier 曲線鏈或直線,可設定填色與筆畫顏色、線寬與不透明度。矩形、圓形與橢圓由 Width/Height 決定大小;多邊形、曲線與直線的幾何來自 SetPoints(相對於形狀左上角的 X,Y 座標對),因此九宮格 Position 適用於每種形狀。

每個範本都有自己的 Position(九個錨點之一或 wpCustom)、Angle、Opacity(0..1)、Overlay 模式(soOverlay 疊在既有內容之上,soUnderlay 蓋在其下)與 PageRange。對複合浮水印而言,PageRange 為空的子項會繼承複合浮水印的範圍。

浮水印內部委派給 StampText / StampImage,因此不透明度、旋轉、圖層順序與頁面範圍解析都走與蓋印 API 相同的成熟路徑。

語法

Delphi

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

參數

Watermark浮水印範本執行個體 (TPDFlibTextWatermark、TPDFlibImageWatermark 或 TPDFlibCompositeWatermark);呼叫端擁有該物件,且必須在呼叫後將其釋放

傳回值

0未放置任何浮水印(未載入文件、nil 浮水印,或空文字/影像)
>= 1加上浮水印的頁面數量