ResolvePageNumberPlaceholders

頁面版面、分頁、文字

描述

以最終頁面結構展開並繪製每個延遲的頁碼佔位符

語法

Delphi

Function TPDFlib.ResolvePageNumberPlaceholders: Integer;

ActiveX

Function PDFlib::ResolvePageNumberPlaceholders() As Long

DLL

int DLResolvePageNumberPlaceholders(int InstanceID);

傳回值

傳回已繪製的佔位文字框數量；沒有待處理項目、分頁早已解析、被錄製的頁面已不存在，或文字準備被缺字政策拒絕時傳回 0

備註

方法會在繪製前準備好所有展開後的字串，再回訪被記錄的頁面，並還原每個擷取時的 painter 狀態

第二輪之後，呼叫端所選的頁面、字型、painter 狀態與 kerning 設定都會還原

解析結果對文件不可變，之後再登錄章節或佔位符會傳回 0，避免意外產生重複內容

範例

PDF.StartPageNumberChapter('Chapter 1');
PDF.AddPageNumberPlaceholder(36, 760, 220, 18,
  'Page <%PageNo%> of <%TotalPages%> — <%ChapterPageNo%>/<%ChapterTotalPages%>', 0);

// Add every remaining page and chapter before the second pass
if PDF.ResolvePageNumberPlaceholders= 0 then
  HandlePaginationError;