THotPDF.ConfigureParagraphTextLayout Method
Configures language-specific hyphenation and the composition strategy for an existing paragraph
Declaration
procedure ConfigureParagraphTextLayout(Index: Integer;
const Language: AnsiString; Hyphenator: THPDFHyphenationProvider;
CompositionMode: THPDFParagraphCompositionMode = pcmGreedy);
Unit
HPDFDoc
Parameters
| Name | Purpose |
|---|---|
Index | One-based paragraph identifier returned by CreateParagraph |
Language | BCP 47-style language tag used to select caller-provided hyphenation data and included in shaped-run cache keys |
Hyphenator | Caller-owned provider queried for discretionary word-break positions, or nil to disable dictionary hyphenation |
CompositionMode | pcmGreedy for minimum latency or pcmOptimal for bounded global line scoring |
Usage notes
- Call the method before
BeginParagraphor while the selected paragraph is active - The hyphenation provider remains caller-owned and must outlive every paragraph that uses it
- Unicode line breaking remains active when
Hyphenatorisnil - Optimal composition uses the same measured glyph advances and legal break opportunities as final output