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;

Prepara una appearance reale di pushbutton usando gli stessi consumer di caption, stato, font e layout della creazione XFA headless automatica; Text è UTF-8, Style sono i metadati emessi dal callback di layout XFA, e Width/Height sono punti PDF fisici

TrueTypeFont fornisce il programma predefinito reale; Options.CaptionFontFamilies fornisce programmi aggiuntivi reali regular, bold, italic e bold-italic, con le loro etichette dichiarate

FirstObjectNumber deve essere positivo e lasciare spazio a tutti i numeri di oggetti consecutivi generati; il bundle restituito possiede gli oggetti nativi raggiungibili e le radici separate delle proprietà del widget e del font predefinito

La factory non modifica mai un documento del chiamante né scrive in uno stream del chiamante; i controlli su font, glifi, input, oggetti, byte di serializzazione e cancellazione si applicano durante la preparazione

Con ResolvedCaptionRuns nil, il percorso esistente delle famiglie configurate è preservato; l'override opzionale supporta un catalogo di font installati risolto separatamente senza sostituire testo o formattazione dell'autore

Un override non vuoto richiede il payload corrente della caption rich e corrispondenza esatta di numero di run, testo, stile, dimensione, colore, sottolineato, barrato, confine di paragrafo, allineamento e FontFamilyCandidates ordinati; solo FontFamily può cambiare verso un'etichetta configurata

Il fallback condiviso dei font sceglie quindi una famiglia reale che copre il grafema completo attraverso tutti gli stili partecipanti; i programmi bold o italic mancanti non vengono mai sintetizzati

I metadati delle caption normal/down/rollover, le caption vuote esplicite, le caption nascoste e il normale comportamento a riserva zero seguono le semantiche delle caption dei pushbutton