HPDFPrepareHeadlessRichTextLineBoxes
function HPDFPrepareHeadlessRichTextLineBoxes(
const Runs: THPDFHeadlessRichTextRuns; MaximumRuns: Integer;
CancellationToken: THPDFCancellationToken = nil): THPDFHeadlessRichTextRuns;Restituisce una sequenza di run separata con gli strut di paragrafo solo-metrica richiesti dalle interlinee rich esplicite; non modifica i record di run autoriali del chiamante
MaximumRuns deve essere compreso tra uno e 4096 e include gli strut inseriti; superare quella capacità solleva EHPDFHeadlessAppearanceError con haLimitExceeded
Un paragrafo con un'altezza esplicita riceve uno strut copiato dalla sua prima run autoriale quando non esiste uno strut esplicito; una prima altezza legacy diventa normal, e le altre altezze figlie legacy restano normal invece di ereditare un fattore da un sibling
Una run IsParagraphStrut esistente deve essere la prima run vuota del proprio paragrafo e deve portare un'altezza non legacy; un piazzamento malformato delle run metriche solleva haInvalidOptions
ParagraphBreakBefore si sposta sullo strut inserito così che il testo plain conservi esattamente i confini di paragrafo originali; i paragrafi tutti legacy preservano la loro sequenza e i loro valori di run esistenti
I pianificatori dei font dovrebbero includere ogni run non vuota e ogni run IsParagraphStrut della sequenza preparata, perché gli strut vuoti richiedono le metriche reali della propria face e del proprio stile forniti
Il token di cancellazione opzionale viene verificato durante la preparazione e propaga EHPDFOperationCancelled; la funzione non esegue accesso a file, caricamento di font, pubblicazione PDF né commit di callback
La preparazione valida la propria struttura di paragrafo limitata; la validazione ordinaria di Unicode, colore, dimensione, programmi font e budget di oggetti resta al serializzatore rich e al builder di appearance