HPDFXFABuildChoiceFieldAppearance

Модуль: 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;

Готовит одно нативное choice-поле типа combo или list, не меняя документ или выходной поток вызывающего, используя те же потребители опций, выбора, прокрутки и внешнего вида, что и автоматическое headless-создание XFA

Kind принимает combo или list; Value и Items содержат текст UTF-8, Width и Height — физические PDF-пункты, а Style содержит метаданные, выпущенные колбэком раскладки XFA

Точные массивы export и display и сырой выбор в Style имеют приоритет над аргументами совместимости Items и Value, сохраняя авторские пробелы и отдельные отображаемые подписи

Возвращаемый бандл содержит V, Opt, I при выборе, TI для списков, Ff и Q, а также AP и DA по запросу; он не включает идентичности поля и страницы, родителя и прямоугольник

Списки с множественным выбором хранят реальный массив значений PDF и выбранные индексы в порядке опций; редактируемые combos сохраняют свободный текст, не выдумывая индекс опции

TrueTypeFont передаёт фактическую шрифтовую программу для генерации appearances; список прокручивается, чтобы показать выбранные опции, используя фактические метрики шрифта, и закрашивает выбранные строки их отображаемыми подписями

GenerateAppearance по умолчанию True; False готовит только метаданные, не требует шрифтовой программы, не создаёт AP или DA и не делает глифовой работы; список только с метаданными стартует с первого выбранного индекса, поскольку метрики просмотрщика определят его итоговый viewport

FirstObjectNumber обязан быть положительным и оставлять место для всех последующих сгенерированных номеров объектов; вызывающий резервирует этот диапазон, принимает объекты и регистрирует Fonts в своём AcroForm DR перед прикреплением Properties к фактическому виджету

Бандл владеет всеми объектами до отсоединения, а лимиты входа, объектов, шрифтов, глифов, сериализованных байтов и отмены из Options действуют на протяжении всей подготовки

О Windows-потребителе THotPDF см. legacy choice-поля XFA