THPDFHeadlessDocument.SaveRichTextFieldUpdatesToFile
function SaveRichTextFieldUpdatesToFile(const FileName: string;
const Updates: THPDFHeadlessRichTextFieldUpdates;
const Options: THPDFHeadlessFormDataOptions): Integer;Připraví a atomicky publikuje jedno nezávislé PDF obsahující skalární textové, choice i button aktualizace spolu s původními typovanými rich-text runy; vrátí počet změněných polí, zatímco načtený dokumentový graf zůstává beze změny
Aktuální graf se serializuje do soukromé autentizované revize, dřív než se aplikují aktualizace; stávající neuložené editace stránek a polí, přihlašovací údaje AES R5/R6, šifrovací identifikátory i podepsané zdrojové prefixy zůstávají kandidátovi dostupné
Typované runy generují appearance přímo, bez round tripu rich XML encode/decode; /V a /RV popisují autorský text a styly, zatímco /AP si uchovává PDF číselnou přesnost stávajícího appearance engine pro původní typované velikosti a barvy
Typovaný no-op vyžaduje ekvivalentní prosté i rich hodnoty plus stejné generované appearance streamy i rozřešené grafy písem/resource pro každý widget; porovnání dešifruje stávající streamy a normalizuje nepřímé objektové reference, místo aby spoléhalo jen na kvantované barvy /RV
Tím se dovolí skutečně nezměněná read-only či podpisem zamčená pole; jiná skutečná malovací barva, velikost, dodané písmo či widget appearance se řídí běžnými omezeními read-only, FieldMDP a DocMDP, i když se serializovaná rich hodnota náhodou shoduje
Porovnání je ke stávajícím appearance konzervativní: externě autorská PDF s ekvivalentním vizuálním výsledkem, ale jinou operátorovou či resource reprezentací mohou vyžadovat běžnou chráněnou aktualizaci
Když je každé vyžádané pole nezměněné a načtený graf nemá čekající editace, publikované PDF je bajt za bajt shodné s načteným zdrojem, tedy včetně stávajících šifrovacích bajtů AES i autentizovaných podpisových revizí; prázdné aktualizační pole se řídí stejným pravidlem, podléhajíc stávajícím kontrolám kompatibility zdroje
Čekající editace v grafu volajícího se do kandidáta serializují jednou, i když tato metoda vrátí nulu změn polí; nesouvisející neuložené změny stránek či polí se zachovají a původní načtený graf zůstává beze změny
Publikace s nulou aktualizací pořád provede validaci oprávnění a podpisů, kontroly aliasů zdroj/cíl, kontroly výstupního rozpočtu, zrušení i atomickou náhradu cíle; read-only a uzamčená pole vyžadují skutečnou shodu hodnoty i appearance
Toto bajty-chovající chování platí pro tuhle transakční metodu; obecná metoda SaveToFile i samostatná import API FDF/XFDF si ponechávají své stávající save chování
Počet polí, duplicitní názvy, Unicode, velikosti hodnot i agregátní textové kapacity řídí Options; počet typovaných runů, agregátní glyph unit, dodané font bajty, rich hodnotové bajty, generované objekty i bajty porovnávání appearance řídí navíc limity načteného dokumentu
Sdílené spravované pole font bajtů se napříč aktualizacemi počítá jednou; odlišné alokace konzumují samostatnou vstupní font kapacitu, i když se jejich bajty shodují, zatímco rozpočty generovaných PDF objektů i výstupu pořád pokrývají všechna appearance
Pro formulářové i appearance volby použijte cancellation token dokumentu; neplatná pole, poškozené hodnoty, oprávnění, neúspěšná autentizace podpisů, zrušení či selhání rozpočtů ponechají předchozí cíl nedotčený a aliasy zdroj/cíl se odmítají
Toto API pokrývá nativní smíšené transakce; Windows JSON typed-rich vyplňování, starší rozšíření job callbacků, anotační interchange i vložená či inkrementální FDF data jsou samostatná workflow