BeginDeferredPageLayer

頁面版面、向量圖形、內容串流

描述

開始把繪圖操作錄製到與所選頁面關聯的整頁延遲圖層

語法

Delphi

Function TPDFlib.BeginDeferredPageLayer(ZIndex: Integer): Integer;

ActiveX

Function PDFlib::BeginDeferredPageLayer(ZIndex As Long) As Long

DLL

int DLBeginDeferredPageLayer(int InstanceID, int ZIndex);

參數

ZIndex	排隊圖層合成時使用的帶正負號疊放值

傳回值

錄製開始時傳回 1；未選取頁面、有另一個延遲圖層/Form XObject/平鋪圖樣作用中、頁面尺寸無效、排隊圖層屬於其他頁面，或已達 1024 層上限時傳回 0

備註

負 z-index 會放在合成前既有頁面內容之下，零與正值則放在其上

z-index 相同的圖層保持原本的記錄順序

目標頁面以間接物件身分追蹤，因此搬移該頁面不會分離其排入佇列的圖層

繪製完圖層後請呼叫 EndDeferredPageLayer

範例

if PDF.BeginDeferredPageLayer(-100)= 1 then
begin
  PDF.SetFillColor(0.95, 0.95, 0.95);
  PDF.DrawBox(0, 0, PDF.PageWidth, PDF.PageHeight, 1);
  PDF.EndDeferredPageLayer;
end;