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各ページの完全な領域の正の寸法
Columns1~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