THotPDF.ConfigureParagraphTextLayout Method
為既有的段落設定特定語言的斷字與組版策略
宣告
procedure ConfigureParagraphTextLayout(Index: Integer;
const Language: AnsiString; Hyphenator: THPDFHyphenationProvider;
CompositionMode: THPDFParagraphCompositionMode = pcmGreedy);
單元
HPDFDoc
參數
| 名稱 | 用途 |
|---|---|
Index | CreateParagraph 傳回、從 1 起算的段落識別碼 |
Language | BCP 47 風格的語言標籤,用於選擇呼叫端提供的斷字資料,並計入 shaped-run 快取鍵 |
Hyphenator | 呼叫端自有的 provider,用於查詢可自由斷行的位置;傳 nil 則停用字典斷字 |
CompositionMode | pcmGreedy 追求最低延遲,pcmOptimal 則做有界限的全域分行評分 |
使用說明
- 請在
BeginParagraph之前,或目標段落仍在作用中時呼叫本方法 - 斷字 provider 仍由呼叫端擁有,生命週期必須涵蓋所有使用它的段落
Hyphenator為nil時,Unicode 斷行仍然有效- optimal 組版與最終輸出使用同一組量測過的字形寬度與合法斷行點