AddPageNumberPlaceholder
頁面版面、分頁、文字
描述
在所選頁面登錄文字框，延後繪製，直到最終頁數與章節數確定
語法
Delphi
Function TPDFlib.AddPageNumberPlaceholder(Left, Top, Width, Height: Double; Const Text: WideString; Options: Integer): Integer;ActiveX
Function PDFlib::AddPageNumberPlaceholder(Left As Double, Top As Double, Width As Double, Height As Double, Text As String, Options As Long) As LongDLL
int DLAddPageNumberPlaceholder(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t* Text, int Options);
int DLAddPageNumberPlaceholderA(int InstanceID, double Left, double Top, double Width, double Height, const char* Text, int Options);參數
| Left, Top, Width, Height | 文字框幾何，依目前座標系統 |
|---|---|
| Text | 含分頁 token 與一般文字的範本 |
| Options | 垂直放置與不自動換行選項，0 到 5，意義與 DrawTextBox 相同 |
Tokens
<%PageNo%> | 實體的所選頁碼 |
|---|---|
<%TotalPages%> | 文件最終頁數 |
<%ChapterPageNo%> | 目前章節內的頁碼（1 起算） |
<%ChapterTotalPages%> | 目前章節的最終頁數 |
<%ChapterName%> | StartPageNumberChapter 登錄的名稱 |
傳回值
傳回以 1 起算的佔位符識別碼；幾何、選項、文字、選取無效，或文件的佔位符早已解析時傳回 0
備註
此呼叫會擷取所選字型、文字大小、顏色、對齊、間距、kerning、裝飾、縮放、原點與轉換後的文字框幾何，不繪製頁面內容
日期、時間與自訂 OnCalcVariable token 遵循與 ExpandVariableTokens 相同的規則呼叫
在完整頁面結構穩定之後、儲存之前，呼叫 ResolvePageNumberPlaceholders 恰好一次