THotPDF.ImportLoadedFormFromXFDF Method

Importerar formulärfältsvärden från en XML Forms Data Format (XFDF)-fil till det inlästa dokumentet

Importen är atomisk över alla fält: en avvisad senare uppdatering rullar tillbaka tidigare värden och genererade utseenden, medan en lyckad import bevarar en av anroparen ägd omslutande graftransaktion

Flera värdeelement fyller ett flervalsväljfält utan att sammanfoga eller dela text på radbrytningar; understödda val byggar om fältvärdet och valindexen utan att ändra föräldrastandardvärden eller syskonfält

Ett fältelement utan värde lämnar det befintliga fältet oförändrat; ett tomt värde rensar ett flervalsfält utan tomt exportalternativ, eller väljer det alternativet när det finns

Arrayvärden valideras innan deras målfält ändras; begär explicit omgenerering av utseenden innan du sparar när synlig text eller väljerutseenden måste ändras

Exakta alternativvärden har företräde i hela den importerade vallistan, oavsett alternativordning; endast omatchad XFDF-text kan använda kompatibilitetsreservvägen för hexadecimala stavningar, och en lyckad reservväg lagrar det faktiskt matchade alternativvärdet

Lågnivå HPDFXFDFImportFields överbelastningen accepterar en separat, initierad THPDFXFDFArrayAccess -posten; dess setter returnerar true efter att ha hanterat hela värdelistan, annars faller ett enstaka värde tillbaka till skalärsettern och flera värden avvisas

Den ursprungliga lågnivåöverbelastningen behåller sitt äldre beteende för befintliga integrationer, inklusive att sammanfoga flera värden med LF; THotPDF

Syntax

function ImportLoadedFormFromXFDF(const AFileName: TFileName): Integer;

Parametrar

AFileName: TFileName

Filnamnet för XFDF-data som ska importeras.

Returvärde

Returnerar antalet formulärfält som uppdaterats framgångsrikt, eller en negativ felkod om importen misslyckas