Méthode THotPDF.ImportLoadedFormFromXFDF

Importe les valeurs de champs de formulaire depuis un fichier XML Forms Data Format (XFDF) dans le document chargé

L’importation est atomique sur l’ensemble des champs : une mise à jour ultérieure rejetée annule les valeurs antérieures et les apparences générées, tandis qu’une importation réussie préserve toute transaction de graphe englobante détenue par l’appelant

Plusieurs éléments de valeur peuplent un champ de liste multi-sélection sans joindre ni scinder le texte sur les sauts de ligne ; les sélections prises en charge reconstruisent la valeur du champ et les indices de sélection sans modifier les défauts des ancêtres ni les champs frères

Un élément de champ sans valeur laisse le champ existant inchangé ; une valeur vide unique efface un champ multi-sélection sans option d’export vide, ou sélectionne cette option lorsqu’elle existe

Les valeurs tableaux sont validées avant de modifier leur champ cible ; demandez explicitement la régénération des apparences avant l’enregistrement lorsque les apparences visibles de texte ou de liste doivent changer

Les valeurs d’option exactes sont prioritaires sur l’ensemble de la liste de sélections importée, quel que soit l’ordre des options ; seul du texte XFDF sans correspondance peut utiliser le repli de compatibilité pour les notations hexadécimales, et un repli réussi stocke la valeur d’option réellement appariée

La surcharge de bas niveau HPDFXFDFImportFields accepte un enregistrement THPDFXFDFArrayAccess séparé et initialisé ; son setter renvoie vrai après avoir traité la liste complète des valeurs, sinon une valeur unique retombe sur le setter scalaire et plusieurs valeurs sont rejetées

La surcharge de bas niveau d’origine conserve son comportement historique pour les intégrations existantes, y compris la jonction de plusieurs valeurs avec LF ; THotPDF utilise la nouvelle surcharge consciente des tableaux

Syntaxe

function ImportLoadedFormFromXFDF(const AFileName: TFileName): Integer;

Paramètres

AFileName: TFileName

Le nom du fichier des données XFDF à importer

Valeur de retour

Renvoie le nombre de champs mis à jour ; un fichier manquant renvoie zéro, tandis que les E/S fichier et les mises à jour de champs rejetées peuvent lever des exceptions