HPDFXFABuildButtonAppearance

Unit: HPDFXFAHeadless

function HPDFXFABuildButtonAppearance(const Text, Style: AnsiString;
  Width, Height: Double; const TrueTypeFont: SysUtils.TBytes;
  FirstObjectNumber: Integer; const Options: TXFAHeadlessPDFOptions;
  const ResolvedCaptionRuns: THPDFHeadlessRichTextRuns = nil): THPDFXFAButtonAppearance;

Připraví jednu skutečnou pushbutton appearance pomocí stejných konzumentů caption, stavu, písem i layoutu jako automatické headless vytváření XFA; Text je UTF-8, Style jsou metadata emitovaná XFA layout callbackem a Width/Height jsou fyzické PDF body

TrueTypeFont dodává skutečný default program; Options.CaptionFontFamilies dodává další reálné programy regular, bold, italic a bold-italic, i s jejich deklarovanými popisky

FirstObjectNumber musí být kladné a nechat prostor pro všechna generovaná následná objektová čísla; vrácená bundle vlastní dosažitelné nativní objekty a samostatné kořeny vlastností widgetu i default fontu

Factory nikdy nemění dokument volajícího ani nezapisuje do jeho streamu; kontroly písem, glyfů, vstupu, objektů, serializovaných bajtů i zrušení platí během přípravy

S nil ResolvedCaptionRuns zůstává zachovaná stávající cesta nakonfigurované rodiny; volitelný override podporuje samostatně rozřešený katalog instalovaných písem, aniž by nahradil autorský text či formátování

Neprázdný override vyžaduje aktuální rich caption payload a přesně odpovídající počet runů, text, styl, velikost, barvu, podtržení, přeškrtnutí, hranici odstavce, zarovnání i uspořádané FontFamilyCandidates; měnit se může jen FontFamily na nakonfigurovaný popisek

Sdílený font fallback pak vybere reálnou rodinu pokrývající kompletní grafém napříč všemi zúčastněnými styly; chybějící programy bold či italic se nikdy nesyntetizují

Metadata caption normal/down/rollover, explicitně prázdné caption, skryté caption i výchozí chování nulové rezervy řídí sémantika pushbutton caption