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;

Prépare un champ de choix natif combo ou list sans modifier un document ou flux de sortie de l'appelant, avec les mêmes consommateurs d'options, de sélection, de défilement et d'apparence que la création XFA headless automatique

Kind vaut combo ou list ; Value et Items contiennent du texte UTF-8, Width et Height sont des points PDF physiques, et Style contient les métadonnées émises par le callback de layout XFA

Les tableaux d'export et d'affichage exacts et la sélection brute dans Style priment sur les arguments de compatibilité Items et Value, en préservant les blancs rédigés et les étiquettes d'affichage séparées

Le bundle retourné contient V, Opt, I en cas de sélection, TI pour les listes, Ff et Q, plus AP et DA sur demande ; il exclut l'identité de champ, l'identité de page, le parent et le rectangle

Les listes multi-sélection stockent un véritable tableau de valeurs PDF et des index sélectionnés dans l'ordre des options ; les combos éditables conservent le texte libre sans inventer d'index d'option

TrueTypeFont fournit le programme de police réel des apparences générées ; une liste défile pour montrer les options sélectionnées grâce aux métriques réelles de police et peint les lignes sélectionnées avec leurs étiquettes d'affichage

GenerateAppearance vaut True par défaut ; False prépare uniquement les métadonnées, n'exige aucun programme de police, ne crée ni AP ni DA et n'effectue aucun travail de glyphes ; une liste à métadonnées seules démarre à son premier index sélectionné car les métriques du lecteur déterminent son viewport éventuel

FirstObjectNumber doit être positif et laisser la place à tous les numéros d'objets générés consécutifs ; l'appelant réserve cette plage, adopte les objets et enregistre Fonts dans son DR AcroForm avant d'attacher Properties à un vrai widget

Le bundle possède tous les objets jusqu'au détachement, et les limites d'entrée, d'objets, de police, de glyphes, d'octets sérialisés et d'annulation dans Options s'appliquent durant toute la préparation

Pour le consommateur Windows THotPDF, voir les champs de choix XFA legacy