HPDFPrepareHeadlessRichTextLineBoxes

function HPDFPrepareHeadlessRichTextLineBoxes(
  const Runs: THPDFHeadlessRichTextRuns; MaximumRuns: Integer;
  CancellationToken: THPDFCancellationToken = nil): THPDFHeadlessRichTextRuns;

Vrací samostatnou sekvenci runů s metrickými paragraph struts, které potřebují explicitní rich line heights; autorské runové záznamy volajícího nemění

MaximumRuns musí být od jedné do 4096 a zahrnuje vložené struts; překročení té kapacity vyhodí EHPDFHeadlessAppearanceError s haLimitExceeded

Odstavec s explicitní výškou dostane strut zkopírovaný ze svého prvního autorského runu, když explicitní strut neexistuje; legacy první výška se stane normal a ostatní legacy podřízené výšky zůstávají normal, místo aby dědily sourozenecký koeficient

Existující run IsParagraphStrut musí být prvním prázdným runem svého odstavce a musí nést nelegacy výšku; poškozené umístění metrického runu vyhodí haInvalidOptions

ParagraphBreakBefore se přesune do vloženého strutu, takže prostý text si zachová přesně původní hranice odstavců; odstavce čistě legacy si ponechávají svou stávající runovou sekvenci a hodnoty

Font plánovači by měli zahrnout každý neprázdný run a každý run IsParagraphStrut z připravené sekvence, protože prázdné struts vyžadují metriky skutečně dodaného řezu a stylu

Volitelný cancellation token se dotazuje během přípravy a propaguje EHPDFOperationCancelled; funkce neprovádí žádný přístup k souborům, načítání písem, publikaci PDF ani commit callbacků

Příprava validuje svou ohraničenou strukturu odstavců; běžnou validaci Unicode, barev, velikostí, font programů i objektových rozpočtů si nechávají rich serializátor a appearance builder

Chování line-height · Run záznam