SetPageHeaderFooterVariant

頁面版面、分頁、HTML 文字

描述

在具名且可重複使用的頁首/頁尾集合中，建立或取代一個變體

語法

Delphi

Function TPDFlib.SetPageHeaderFooterVariant(Const SetName, VariantName,
  Text: WideString; Margin, Height, Opacity: Double; Alignment,
  IsHeader, RichText: Integer): Integer;

ActiveX

Function PDFlib::SetPageHeaderFooterVariant(SetName As String,
  VariantName As String, Text As String, Margin As Double,
  Height As Double, Opacity As Double, Alignment As Long,
  IsHeader As Long, RichText As Long) As Long

DLL

int DLSetPageHeaderFooterVariant(int InstanceID, const wchar_t* SetName,
  const wchar_t* VariantName, const wchar_t* Text, double Margin,
  double Height, double Opacity, int Alignment, int IsHeader, int RichText);
int DLSetPageHeaderFooterVariantA(int InstanceID, const char* SetName,
  const char* VariantName, const char* Text, double Margin,
  double Height, double Opacity, int Alignment, int IsHeader, int RichText);

參數

SetName	屬於同一範本集合的各變體共用的名稱（不分大小寫）
VariantName	default、first、odd 或 even，比對不分大小寫
Text	為每個所選頁面分別展開的文字或 HTML 範本；空值會建立明確的空白變體並抑制回退
Margin	與相關頁面邊緣的非負距離
Height	內容框高度；0 表示自動量測純文字行或 HTML 內容
Opacity	值從 0（完全透明）到 1（完全不透明）
Alignment	0 為靠左、1 為置中、2 為靠右
IsHeader	1 為頁首，0 為頁尾
RichText	1 把 Text 當成 HTML 描繪；0 使用目前選取的字型與 painter 狀態

傳回值

Variant 已儲存時傳回 1；名稱、Variant、數值、對齊或旗標無效時傳回 0

備註

以相同的集合名稱、變體名稱與頁首/頁尾角色再次呼叫，會取代既有定義

範本支援與 AddPageHeader 相同的 & 記號與 <%name%> 欄位，包括由 OnCalcVariable 解析的自訂變數定義歸屬於

TPDFlib 實例，可套用到多份文件

範例

PDF.SetPageHeaderFooterVariant('manual', 'first', '', 36, 0, 1, 0, 1, 0);
PDF.SetPageHeaderFooterVariant('manual', 'odd', 'Chapter — <%PageNo%>', 36, 0, 1, 2, 1, 0);
PDF.SetPageHeaderFooterVariant('manual', 'even', '<%PageNo%> — Chapter', 36, 0, 1, 0, 1, 0);