THPDFHeadlessDocument.SaveRichTextFieldUpdatesToFile
function SaveRichTextFieldUpdatesToFile(const FileName: string;
const Updates: THPDFHeadlessRichTextFieldUpdates;
const Options: THPDFHeadlessFormDataOptions): Integer;スカラーテキスト、選択肢、ボタンの各更新を、元の型付きリッチテキスト run とともに含む 1 つの独立した PDF を準備してアトミックに公開します。読み込み済みドキュメントグラフを変更せずに、変更フィールド数を返します
現在のグラフは、更新を適用する前にプライベートな認証済みリビジョンへシリアライズされます。未保存の既存ページ・フィールド編集、AES R5/R6 資格情報、暗号化識別子、署名済みソース接頭辞は、候補から引き続き利用できます
型付き run は、リッチ XML のエンコード／デコード往復なしで外観を直接生成します。/V と /RV は記述されたテキストとスタイルを表し、/AP は元の型付きサイズと色について、既存の外観エンジンの PDF 数値精度を保ちます
型付きの無変更には、同等のプレーン値とリッチ値に加え、すべてのウィジェットで生成外観ストリームと解決済みフォント／リソースグラフが一致することが必要です。比較では、量子化された /RV 色だけを信用するのではなく、既存ストリームを復号し間接オブジェクト参照を正規化します
これにより、本当に変更されていない読み取り専用や署名ロック済みフィールドが許されます。実際の塗り色、サイズ、供給フォント、ウィジェット外観が違う場合は、シリアライズ済みリッチ値がたまたま同じでも、通常の読み取り専用、FieldMDP、DocMDP の各制限に従います
比較は既存の外観について保守的です。視覚結果が同等でも演算子やリソース表現が異なる外部作成の PDF では、通常の保護付き更新が必要になることがあります
要求されたすべてのフィールドが無変更で、ロード済みグラフに保留編集がない場合、公開される PDF はロード済みソースとバイト単位で同一になります。既存の AES 暗号化バイトや認証済み署名リビジョンも含まれます
呼び出し側グラフの保留編集は、このメソッドがフィールド変更ゼロを返す場合でも 1 回だけ候補へシリアライズされます。無関係な未保存のページ・フィールド変更は保持され、元のロード済みグラフは呼び出し側の現在状態のままです
更新ゼロの公開でも、権限と署名の検証、ソース/宛先エイリアスのチェック、出力予算チェック、キャンセル、アトミックな宛先置き換えは行われます。読み取り専用フィールドとロック済みフィールドは、文書化された権限を必要とします
このバイト保持動作は、このトランザクショナルなメソッドに適用されます。汎用の SaveToFile メソッドと独立した FDF/XFDF インポート API は、既存の保存動作をそのまま保ちます
フィールド数、重複名、Unicode、値サイズ、テキスト合計容量には Options を使い、型付き run 数、グリフユニット合計、供給フォントバイト、リッチ値バイト、生成オブジェクト、外観比較バイトにも読み込み済みドキュメント上限を使います
共有された管理フォントバイト配列は、更新全体で 1 回だけ数えられます。別々に確保された配列は、バイトが一致していても別々の入力フォント容量を消費します。生成 PDF オブジェクトと出力予算は引き続きすべての外観をカバーします
フォームと外観のオプションには、ドキュメントのキャンセルトークンを使ってください。無効なフィールド、不正な値、権限、署名認証の失敗、キャンセル、予算失敗では以前の宛先がそのまま保たれ、ソース／宛先のエイリアスは拒否されます
この API がカバーするのはネイティブの混在トランザクションです。Windows の JSON 型付きリッチ入力、旧ジョブコールバック拡張、注釈インターチェンジ、埋め込みまたはインクリメンタル FDF データは、別のワークフローです