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 | ページ番号トークンと通常テキストを含むテンプレート |
| Options | 0~5 の垂直配置および折り返し禁止オプションで、DrawTextBox と同じ意味です |
Tokens
<%PageNo%> | 選択された物理ページ番号 |
|---|---|
<%TotalPages%> | 最終的なドキュメントのページ数 |
<%ChapterPageNo%> | 現在の章内の 1 から始まるページ番号 |
<%ChapterTotalPages%> | 現在の章の最終ページ数 |
<%ChapterName%> | StartPageNumberChapter で登録された名前 |
戻り値
1 から始まるプレースホルダー識別子を返します。ジオメトリ、オプション、テキスト、選択が無効な場合、または文書のプレースホルダーがすでに解決されている場合は 0 を返します
備考
呼び出しはページコンテンツを描画せずに、選択フォント、テキストサイズ、色、配置、間隔、カーニング、装飾、スケール、原点、変換済みテキストボックス幾何情報を取得します
日付、時刻、カスタム OnCalcVariable トークンは ExpandVariableTokens と同じ規則を使用します
ページ構造が完全に安定した後、保存前に ResolvePageNumberPlaceholders を正確に 1 回呼び出します