THotPDF.ImportLoadedFormFromXFDF Method

Importeert formulierveldwaarden uit een XML Forms Data Format (XFDF)-bestand in het geladen document

De import is atomisch over alle velden: een geweigerde latere update draait eerdere waarden en gegenereerde appearances terug, terwijl een geslaagde import een eventuele omhullende grafiektransactie van de aanroeper intact laat

Meerdere waarde-elementen vullen een multi-select-keuzeveld zonder tekst op regeleinde samen te voegen of te splitsen; ondersteunde selecties herbouwen de veldwaarde en selectie-indices zonder voorouderlijke standaardwaarden of zustervelden te wijzigen

Een veldelement zonder waarde laat het bestaande veld ongewijzigd; één lege waarde wist een multi-select-veld zonder lege exportoptie, of selecteert die optie wanneer die bestaat

Arraywaarden worden gevalideerd voordat hun doelveld verandert; vraag expliciet appearance-regeneratie aan vóór het opslaan wanneer zichtbare tekst of keuzeweergaven moeten wijzigen

Exacte optiewaarden hebben prioriteit over de volledige geïmporteerde selectielijst, ongeacht de volgorde van de opties; alleen XFDF-tekst zonder match mag de compatibiliteitsfallback voor hexadecimale spellingen gebruiken, en een geslaagde fallback slaat de werkelijk gematchte optiewaarde op

De low-level HPDFXFDFImportFields-overload accepteert een apart, geïnitialiseerd THPDFXFDFArrayAccess-record; diens setter geeft true terug na verwerking van de volledige waardelijst, anders valt één waarde terug op de scalaire setter en worden meerdere waarden geweigerd

De oorspronkelijke low-level-overload behoudt zijn legacy-gedrag voor bestaande integraties, inclusief het samenvoegen van meerdere waarden met LF; THotPDF gebruikt de nieuwe arraybewuste overload

Syntax

 function ImportLoadedFormFromXFDF(const AFileName: TFileName): Integer; 

Parameters

AFileName: TFileName

De bestandsnaam van de te importeren XFDF-gegevens

Retourwaarde

Geeft het aantal bijgewerkte velden terug; een ontbrekend bestand geeft nul terug, terwijl bestands-I/O en geweigerde veldupdates uitzonderingen kunnen geven