THPDFHeadlessDocument.SaveRichTextFieldUpdatesToFile
function SaveRichTextFieldUpdatesToFile(const FileName: string;
const Updates: THPDFHeadlessRichTextFieldUpdates;
const Options: THPDFHeadlessFormDataOptions): Integer;Forbered og publicér atomisk én uafhængig PDF med scalar-tekst-, choice- og button-opdateringer sammen med originale typede rich text-runs; returnér antallet af ændrede felter, mens den indlæste dokumentgraf forbliver uændret
Den aktuelle graf serialiseres til en privat autentificeret revision, før opdateringerne anvendes; eksisterende ugernede side- og feltredigeringer, AES R5/R6-legitimationsoplysninger, krypteringsidentifikatorer og signerede kildepræfikser forbliver tilgængelige for kandidaten
Typede runs genererer appearances direkte uden en rich XML encode/decode-rundtur; /V og /RV beskriver den authored tekst og styles, mens /AP beholder den eksisterende appearance-engines PDF numeriske præcision for de originale typede størrelser og farver
En typet no-op kræver ækvivalente plain- og rich-værdier plus ens genererede appearance-streams og opløste font/ressourcegrafer for hver widget; sammenligningen dekrypterer eksisterende streams og normaliserer indirekte objektreferencer i stedet for at stole alene på kvantiserede /RV-farver
Det tillader rigtig uændrede skrivebeskyttede eller signatur-låste felter; en anden faktisk malefarve, størrelse, leveret font eller widget-appearance følger normale skrivebeskyttelses-, FieldMDP- og DocMDP-begrænsninger, selv når den serialiserede rich-værdi tilfældigvis er identisk
Sammenligningen er konservativ omkring eksisterende appearances: eksternt authorede PDF'er med ækvivalente visuelle resultater men en anden operator- eller ressourcerepræsentation kan kræve en almindelig beskyttet opdatering
Når alle anmodede felter er uændrede, og den indlæste graf ikke har ventende redigeringer, er den publicerede PDF byte-for-byte identisk med den indlæste kilde, inklusive eksisterende AES-krypteringsbytes og autentificerede signaturrevisioner; et tomt update-array følger samme regel under forbehold af de eksisterende kildekompatibilitetstjek
Ventende redigeringer i kaldergrafen serialiseres til kandidaten én gang, selv når denne metode returnerer nul feltændringer; urelaterede ugernede side- eller feltændringer bevares, og den originale indlæste graf forbliver uændret
Nul-opdaterings-publicering udfører stadig tilladelses- og signaturvalidering, kilde/destination-alias-tjek, outputbudget-tjek, cancellation og atomisk destinationserstatning; skrivebeskyttede og låste felter kræver rigtig værdi- og appearance-ækvivalens
Denne bytebevarende adfærd gælder denne transaktionelle metode; den generelle SaveToFile-metode og separate FDF/XFDF import-API'er beholder deres eksisterende gem-adfærd
Feltantal, duplikerede navne, Unicode, værdistørrelser og samlede tekstkapaciteter bruger Options; typet run-antal, samlede glyph units, leverede font-bytes, rich værdi-bytes, genererede objekter og appearance-sammenligningsbytes bruger også de indlæste dokumentgrænser
Et delt managed font byte-array tælles én gang på tværs af opdateringer; distinkte allokeringer forbruger separat input-fontkapacitet, selv når deres bytes matcher, mens genererede PDF-objekt- og outputbudgetter stadig dækker alle appearances
Brug dokumentets cancellation-token til formular- og appearance-options; ugyldige felter, misdannede værdier, tilladelser, mislykket signaturautentifikation, cancellation eller budgetfejl efterlader den tidligere destination intakt, og kilde/destination-aliasser afvises
API'en dækker native blandede transaktioner; Windows JSON typed-rich filling, den ældre job callback-udvidelse, annotationsudveksling og indlejrede eller inkrementelle FDF-data er separate workflows