Метод THotPDF.ImportLoadedFormFromXFDF

Импортирует значения полей формы из файла XML Forms Data Format (XFDF) в загруженный документ

Импорт атомарен по всем полям: отклонённое позднее обновление откатывает предыдущие значения и сгенерированные appearance, а успешный импорт сохраняет объемлющую graph transaction, если вызывающий создал её сам

Несколько элементов value заполняют choice-поле множественного выбора без склейки или разрезания текста по переводам строк; поддерживаемые выборы перестраивают значение поля и индексы выбора, не трогая дефолты предков и соседние поля

Элемент field без value оставляет существующее поле неизменным; один пустой value очищает multi-select поле без пустой export-опции или выбирает эту опцию, если она есть

Значения array валидируются до изменения целевого поля; запрашивайте регенерацию appearance явно до сохранения, когда должны измениться видимый текст или appearance вариантов

Точные значения опций имеют приоритет по всему импортированному списку выбора независимо от порядка опций; compatibility fallback для шестнадцатеричных написаний доступен только несовпадающему тексту XFDF, а успешный fallback сохраняет реально совпавшее значение опции

Низкоуровневая HPDFXFDFImportFields перегрузка принимает отдельную инициализированную THPDFXFDFArrayAccess запись; её setter возвращает true после обработки полного списка значений, иначе одиночное значение уходит в скалярный setter, а несколько значений отклоняются

Исходная низкоуровневая перегрузка сохраняет legacy-поведение для существующих интеграций, включая склейку нескольких значений через LF; THotPDF использует новую перегрузку с поддержкой array

Синтаксис

function ImportLoadedFormFromXFDF(const AFileName: TFileName): Integer;

Параметры

AFileName: TFileName

Имя файла данных XFDF для импорта

Возвращаемое значение

Возвращает число обновлённых полей; отсутствие файла даёт ноль, а файловый I/O и отклонённые обновления полей могут выбрасывать исключения