HPDFXFABuildChoiceFieldAppearance

Unità: HPDFXFAHeadless

function HPDFXFABuildChoiceFieldAppearance(const Kind, Value, Style: AnsiString;
  const Items: TXFAFieldOptions; Width, Height: Double;
  const TrueTypeFont: SysUtils.TBytes; FirstObjectNumber: Integer;
  const Options: TXFAHeadlessPDFOptions;
  GenerateAppearance: Boolean = True): THPDFXFAChoiceAppearance;

Prepara un campo choice nativo combo o list senza modificare documenti o stream di output del chiamante, usando lo stesso consumer di opzioni, selezione, scrolling e appearance della creazione XFA headless automatica

Kind è combo o list; Value e Items contengono testo UTF-8, Width e Height sono punti PDF fisici, e Style contiene i metadati emessi dal callback di layout XFA

Gli array esatti di export e display e la selezione raw in Style hanno la precedenza sugli argomenti di compatibilità Items e Value, preservando gli spazi autoriali e le etichette di display separate

Il bundle restituito contiene V, Opt, I quando selezionato, TI per le liste, Ff e Q, più AP e DA quando richiesti; esclude identità di campo, identità di pagina, parent e rettangolo

Le liste multi-select memorizzano un array di valori PDF reale e gli indici selezionati in ordine di opzione; le combo editabili conservano testo libero senza inventare un indice di opzione

TrueTypeFont fornisce il programma font reale per le appearance generate; una lista scorre per mostrare le opzioni selezionate usando le metriche reali del font e dipinge le righe selezionate con le loro etichette di display

GenerateAppearance fa default a True; False prepara solo i metadati, non richiede programmi font, non crea AP né DA e non esegue lavoro sui glifi; una lista solo-metrica parte dal primo indice selezionato perché le metriche del viewer determinano l'eventuale viewport

FirstObjectNumber deve essere positivo e lasciare spazio a tutti i numeri di oggetto consecutivi generati; il chiamante riserva quel range, adotta gli oggetti e registra i Fonts nel proprio AcroForm DR prima di attaccare Properties a un widget reale

Il bundle possiede tutti gli oggetti finché non vengono distaccati, e i limiti di input, oggetti, font, glifi, byte serializzati e cancellazione in Options si applicano lungo tutta la preparazione

Per il consumer THotPDF Windows, si veda campi choice XFA legacy