THotPDF.ImportLoadedFormFromXFDF-Methode

Importiert Formularfeldwerte aus einer Datei im XML Forms Data Format (XFDF) in das geladene Dokument

Der Import ist über alle Felder atomar: Eine abgelehnte spätere Aktualisierung rollt frühere Werte und erzeugte Darstellungen zurück, während ein erfolgreicher Import jede aufrufereigene umschließende Graph-Transaktion unangetastet lässt

Mehrere value-Elemente befüllen ein Multi-Select-Auswahlfeld, ohne Text an Zeilenumbrüchen zusammenzuführen oder zu trennen; unterstützte Auswahlen bauen den Feldwert und die Auswahlindizes neu auf, ohne übergeordnete Standards oder Geschwisterfelder zu verändern

Ein field-Element ohne value lässt das vorhandene Feld unverändert; ein einzelner leerer value leert ein Multi-Select-Feld ohne leere Exportoption oder wählt genau diese Option, wenn sie existiert

Array-Werte werden validiert, bevor ihr Zielfeld geändert wird; fordern Sie die Neuerzeugung der Darstellungen explizit an, bevor Sie speichern, wenn sich sichtbarer Text oder Auswahl-Darstellungen ändern müssen

Exakte Optionswerte haben in der gesamten importierten Auswahlliste Vorrang, unabhängig von der Reihenfolge der Optionen; nur nicht übereinstimmender XFDF-Text darf den Kompatibilitäts-Fallback für hexadezimale Schreibweisen verwenden, und ein erfolgreicher Fallback speichert den tatsächlich gefundenen Optionswert

Das Low-Level-Overload HPDFXFDFImportFields nimmt einen separaten, initialisierten THPDFXFDFArrayAccess-Record entgegen; sein Setter liefert true, nachdem er die vollständige Wertliste verarbeitet hat, andernfalls fällt ein einzelner Wert auf den skalaren Setter zurück und mehrere Werte werden abgelehnt

Das ursprüngliche Low-Level-Overload behält sein Legacy-Verhalten für bestehende Integrationen bei, einschließlich der Zusammenführung mehrerer Werte mit LF; THotPDF verwendet das neue array-bewusste Overload

Syntax

function ImportLoadedFormFromXFDF(const AFileName: TFileName): Integer;

Parameter

AFileName: TFileName

Der Dateiname der XFDF-Daten, die importiert werden sollen

Rückgabewert

Liefert die Anzahl der aktualisierten Felder; eine fehlende Datei liefert null, während Datei-E/A und abgelehnte Feldaktualisierungen Ausnahmen auslösen können