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 de elección nativo combo o list sin cambiar un documento ni un stream de salida del llamador, usando el mismo consumidor de opciones, selección, scrolling y appearance que la creación headless XFA automática

Kind es combo o list; Value e Items contienen texto UTF-8, Width y Height son puntos PDF físicos, y Style contiene los metadatos emitidos por el callback de layout XFA

Los arrays exactos de export y display y la selección cruda en Style tienen precedencia sobre los argumentos de compatibilidad Items y Value, preservando el whitespace del autor y las etiquetas de display separadas

El bundle devuelto contiene V, Opt, I cuando hay selección, TI para lists, Ff y Q, más AP y DA cuando se solicitan; excluye la identidad de campo, la identidad de página, el padre y el rectángulo

Las lists multi-select almacenan un array de valores PDF real y los índices seleccionados en orden de opciones; los combos editables retienen texto libre sin inventar un índice de opción

TrueTypeFont suministra el programa de fuente real para las appearances generadas; una list hace scrolling para mostrar las opciones seleccionadas usando métricas reales de fuente y pinta las filas seleccionadas con sus etiquetas de display

GenerateAppearance por defecto es True; False prepara solo metadatos, no requiere programa de fuente, no crea AP ni DA y no realiza trabajo de glifos; una list de solo metadatos empieza en su primer índice seleccionado porque las métricas del viewer determinan su viewport eventual

FirstObjectNumber debe ser positivo y dejar espacio para todos los números de objeto generados consecutivos; el llamador reserva ese rango, adopta los objetos y registra Fonts en su AcroForm DR antes de adjuntar Properties a un widget real

El bundle es dueño de todos los objetos hasta que se desprendan, y los límites de entrada, objetos, fuentes, glifos, bytes serializados y cancelación en Options se aplican durante toda la preparación

Para el consumidor Windows THotPDF, vea campos de elección XFA heredados