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;

Bereidt één native combo- of list-choice-veld voor zonder een caller-document of uitvoerstream te wijzigen, met dezelfde option-, selection-, scrolling- en appearance-consumer als automatische headless XFA-creation

Kind is combo of list; Value en Items bevatten UTF-8-tekst, Width en Height zijn fysieke PDF-punten, en Style bevat de metadata die de XFA layout-callback uitschrijft

De exacte export- en display-arrays en raw selectie in Style hebben voorrang op de compatibiliteits-Items- en Value-argumenten, met behoud van authored whitespace en aparte display-labels

De teruggegeven bundel bevat V, Opt, I indien geselecteerd, TI voor lijsten, Ff en Q, plus AP en DA indien gevraagd; hij bevat geen veldidentiteit, pagina-identiteit, parent en rechthoek

Multi-select-lijsten bewaren een echte PDF-waarde-array en geselecteerde indices in optievolgorde; editable combos houden vrije tekst vast zonder een optie-index te verzinnen

TrueTypeFont levert het echte fontprogramma voor gegenereerde appearances; een lijst scrollt om geselecteerde opties te tonen met echte font-metrics en pint geselecteerde rijen met diens display-labels

GenerateAppearance defaultt naar True; False bereidt alleen metadata voor, vraagt geen fontprogramma, maakt geen AP of DA aan en doet geen glyph-werk; een metadata-only-lijst begint op diens eerste geselecteerde index omdat viewer-metrics diens uiteindelijke viewport bepalen

FirstObjectNumber moet positief zijn en ruimte overlaten voor alle aaneengesloten gegenereerde objectnummers; de aanroeper reserveert dat bereik, adopteert de objecten en registreert Fonts in diens AcroForm DR voordat Properties aan een echte widget wordt gekoppeld

De bundel is eigenaar van alle objecten tot ze zijn gedetacht, en invoer-, object-, font-, glyph-, serialized-byte- en annuleringslimieten in Options gelden gedurende de hele voorbereiding

Voor de Windows THotPDF-consumer, zie legacy XFA choice fields