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，或先前故事/文字框呼叫傳回的接續字串

傳回值

故事全部排完時傳回空字串；達到 MaxPages 時傳回接續字串，內含所有未排入的內容與其作用中的 HTML/CSS 狀態輸入無效時傳回

HTMLText 原樣傳回，LastErrorCode 為 121；頁面建立失敗，或連續兩個框架版面毫無進展時，以錯誤 524 傳回剩餘的故事內容

備註

欄位依閱讀順序由左至右填滿後，才會建立新頁

產生的頁面複製所選起始頁的有效寬高，而目前的量測單位、原點、HTML 字型對應、影像繫結、行內樣式、樣式表串接、巢狀樣式堆疊、Flexbox 與 Grid 容器、表格、連結、結構化區塊與註腳編號，都延續同一個渲染器

請在相關本文之後使用 <footnote> 或 <aside style="float:footnote">；被接受的註腳會取得上標標記、在目前框架底部保留獨立區域，並在後續斷行前縮減本文高度

若註腳與其參照放不進同一版面，兩者都會留在接續字串中，等待下一欄或下一頁

此方法對每個框架使用快取的量測與重播計畫，不會把頁面內容串接成單一無上限的版面緩衝區

當有限頁數上限導致仍有剩餘內容時，請建立或選擇想要的接續頁面，並把傳回的字串交給下一次呼叫

另見

DrawHTMLTextBox、DrawTextFlowColumns、附錄 A：支援的 HTML 標籤