THPDFHeadlessDocument.SaveRichTextFieldUpdatesToFile
function SaveRichTextFieldUpdatesToFile(const FileName: string;
const Updates: THPDFHeadlessRichTextFieldUpdates;
const Options: THPDFHeadlessFormDataOptions): Integer;Bereidt en publiceert atomair één onafhankelijke PDF met scalar-tekst-, choice- en button-updates samen met originele getypeerde rich-text-runs; geeft het aantal gewijzigde velden terug terwijl de geladen documentgraaf ongewijzigd blijft
De huidige graaf wordt geserialiseerd naar een privé geauthenticeerde revisie voordat updates worden toegepast; bestaande niet-opgeslagen pagina- en veld-edits, AES R5/R6-credentials, encryptie-identificatoren en signed bron-prefixes blijven beschikbaar voor de candidate
Getypeerde runs genereren appearances direct, zonder een rich XML encode/decode-round-trip; /V en /RV beschrijven de authored tekst en stijlen, terwijl /AP de PDF-numerieke precisie van de bestaande appearance-engine houdt voor de originele getypeerde groottes en kleuren
Een getypeerde no-op vraagt equivalente platte en rich-waarden plus gelijke gegenereerde appearance-streams en opgeloste font/resource-grafen voor elke widget; vergelijking ontsleutelt bestaande streams en normaliseert indirecte objectreferenties, in plaats van alleen te vertrouwen op gequantiseerde /RV-kleuren
Dit staat echt ongewijzigde read-only of signature-locked velden toe; een andere echte verfkleur, grootte, supplied font of widget-appearance volgt de normale read-only-, FieldMDP- en DocMDP-beperkingen zelfs wanneer de geserialiseerde rich-waarde toevallig identiek is
Vergelijking is conservatief over bestaande appearances: extern authored PDF's met equivalente visuele resultaten maar een andere operator- of resource-representatie kunnen een gewone beschermde update vragen
Wanneer elk gevraagd veld ongewijzigd is en de geladen graaf geen pending edits heeft, is de gepubliceerde PDF byte-voor-byte identiek aan de geladen bron, inclusief bestaande AES-encryptie-bytes en geauthenticeerde signature-revisies; een lege update-array volgt dezelfde regel, onder voorbehoud van de bestaande broncompatibiliteits-checks
Pending edits in de caller-graaf worden één keer in de candidate geserialiseerd zelfs wanneer deze methode nul veldwijzigingen teruggeeft; ongerelateerde niet-opgeslagen pagina- of veldwijzigingen worden behouden, en de originele geladen graaf blijft ongewijzigd
Publicatie zonder updates voert nog steeds permission- en signature-validatie, bron-/destination-alias-checks, uitvoerbudget-checks, annulering en atomare destination-vervanging uit; read-only en locked velden vragen echte waarde- en appearance-equivalentie
Dit byte-preserverende gedrag geldt voor deze transactionele methode; de algemene SaveToFile-methode en aparte FDF/XFDF-import-API's behouden diens bestaande save-gedrag
Veldaantal, dubbele namen, Unicode, waardegroottes en geaggregeerde tekstcapaciteiten gebruiken Options; getypeerd run-aantal, geaggregeerde glyph-units, supplied fontbytes, rich-waarde-bytes, gegenereerde objecten en appearance-vergelijking-bytes gebruiken ook de geladen documentlimieten
Een gedeelde managed font-byte-array wordt één keer geteld over updates heen; distincte allocaties verbruiken aparte invoer-fontcapaciteit zelfs wanneer diens bytes matchen, terwijl gegenereerde PDF-object- en uitvoerbudgetten nog steeds alle appearances dekken
Gebruik het annuleringstoken van het document voor formulier- en appearance-options; ongeldige velden, misvormde waarden, permissions, gefaalde signature-authenticatie, annulering of budgetfalen laten de vorige destination intact, en bron-/destination-aliassen worden geweigerd
De API dekt native gemengde transacties; Windows JSON typed-rich-filling, de oudere job-callback-extensie, annotation interchange en embedded of incrementele FDF-data zijn aparte workflows