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 Long

DLL

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ページ番号トークンと通常テキストを含むテンプレート
Options0~5 の垂直配置および折り返し禁止オプションで、DrawTextBox と同じ意味です

Tokens

<%PageNo%>選択された物理ページ番号
<%TotalPages%>最終的なドキュメントのページ数
<%ChapterPageNo%>現在の章内の 1 から始まるページ番号
<%ChapterTotalPages%>現在の章の最終ページ数
<%ChapterName%>StartPageNumberChapter で登録された名前

戻り値

1 から始まるプレースホルダー識別子を返します。ジオメトリ、オプション、テキスト、選択が無効な場合、または文書のプレースホルダーがすでに解決されている場合は 0 を返します

備考

呼び出しはページコンテンツを描画せずに、選択フォント、テキストサイズ、色、配置、間隔、カーニング、装飾、スケール、原点、変換済みテキストボックス幾何情報を取得します

日付、時刻、カスタム OnCalcVariable トークンは ExpandVariableTokens と同じ規則を使用します

ページ構造が完全に安定した後、保存前に ResolvePageNumberPlaceholders を正確に 1 回呼び出します