DrawHTMLStory
HTML テキスト、ページレイアウト、ページネーション
説明
選択したページ上で、スタイル付き HTML ストーリーを左から右へ等幅の列に流し込み、その後、新しく生成されたページへ続けます
構文
Delphi
Function TPDFlib.DrawHTMLStory(Left, Top, Width, Height: Double; Columns: Integer; Gutter: Double; MaxPages: Integer; Const HTMLText: WideString): WideString;DLL
const wchar_t* DLDrawHTMLStory(int InstanceID, double Left, double Top, double Width, double Height, int Columns, double Gutter, int MaxPages, const wchar_t* HTMLText);ActiveX
Function PDFlib::DrawHTMLStory(Left As Double, Top As Double, Width As Double, Height As Double, Columns As Long, Gutter As Double, MaxPages As Long, HTMLText As String) As Stringパラメータ
| Left, Top | 現在の座標系における完全な列領域の左上原点 |
|---|---|
| Width, Height | 各ページの完全な領域の正の寸法 |
| Columns | 1~64 の列数 |
| Gutter | 隣接する列の間に設ける負でない間隔。溝幅の合計は Width 未満でなければなりません |
| MaxPages | 選択したページを含め、この呼び出しで使用するページの最大数です。範囲は 1~10000 です |
| HTMLText | 初期 HTML、または以前の story 呼び出しや text-box 呼び出しから返された継続文字列 |
戻り値
story 全体が配置された場合は空文字列を返します。MaxPages に達した場合は、未配置の全コンテンツとアクティブな HTML/CSS 状態を含む継続文字列を返します
入力が無効な場合は HTMLText を変更せず、LastErrorCode 121 とともに返します。ページ作成に失敗した場合、または 2 つの連続するフレームでレイアウトが進行しない場合は、残りのストーリーをエラー 524 とともに返します
備考
新しいページを作成する前に、列は左から右への読み順で埋められます
生成されるページは、選択した開始ページの有効な幅と高さをコピーします。現在の測定単位、原点、HTML フォントマッピング、画像バインディング、インラインスタイル、スタイルシートカスケード、ネストスタイルスタック、Flexbox と Grid コンテナ、テーブル、リンク、構造化ブロック、脚注番号は同じレンダラーで引き続き使用されます
関連する本文の後に <footnote> または <aside style="float:footnote"> を使用します。受け入れられた注には上付きマーカーが付き、現在のフレーム下部に区切られた領域が確保され、その後の改行処理前に本文の高さが縮小されます
注記とその参照を一緒に収められない場合は、どちらも次の列またはページ用の継続文字列に残ります
このメソッドは各フレームにキャッシュ済みの測定および再生プランを使用し、ページコンテンツを単一の無制限レイアウトバッファーに連結しない
有限のページ上限によって残りのコンテンツが返された場合、必要な継続ページを作成または選択し、返された文字列を別の呼び出しへ渡します
関連項目
DrawHTMLTextBox、DrawTextFlowColumns、Appendix A: Supported HTML tags