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;

Bereitet ein natives Combo- oder List-Choice-Feld vor, ohne ein Aufrufer-Dokument oder einen Ausgabestream zu ändern, und nutzt denselben Option-, Selection-, Scrolling- und Appearance-Consumer wie die automatische headless XFA-Erzeugung

Kind ist combo oder list; Value und Items enthalten UTF-8-Text, Width und Height sind physische PDF-Punkte, und Style enthält die Metadaten aus dem XFA-Layout-Callback

Die exakten Export- und Display-Arrays sowie die rohe Selection in Style haben Vorrang vor den Kompatibilitätsargumenten Items und Value und bewahren authored Whitespace und separate Display-Labels

Das zurückgegebene Bundle enthält V, Opt, I bei Auswahl, TI für Listen, Ff und Q, plus AP und DA auf Anfrage; Feldidentität, Seitenidentität, Parent und Rechteck fehlen

Multi-Select-Listen speichern ein echtes PDF-Wert-Array und ausgewählte Indizes in Optionsreihenfolge; editierbare Combos behalten freien Text, ohne einen Optionsindex zu erfinden

TrueTypeFont liefert das tatsächliche Fontprogramm für erzeugte Appearances; eine Liste scrollt mit echten Font-Metriken zu den ausgewählten Optionen und malt ausgewählte Zeilen mit ihren Display-Labels

GenerateAppearance ist standardmäßig True; False bereitet nur Metadaten vor, braucht kein Fontprogramm, erzeugt kein AP oder DA und leistet keine Glyph-Arbeit; eine reine Metadaten-Liste startet an ihrem ersten ausgewählten Index, weil Viewer-Metriken ihren späteren Viewport bestimmen

FirstObjectNumber muss positiv sein und Platz für alle fortlaufend erzeugten Objektnummern lassen; der Aufrufer reserviert diesen Bereich, übernimmt die Objekte und registriert Fonts in seinem AcroForm-DR, bevor Properties an ein echtes Widget angehängt wird

Das Bundle besitzt alle Objekte bis zum Abkoppeln, und Input-, Objekt-, Font-, Glyph-, Serialized-Byte- und Abbruch-Limits in Options gelten während der gesamten Vorbereitung

Für den Windows-THotPDF-Consumer siehe Legacy-XFA-Choice-Felder