THPDFWindowsFormDataTransaction

HPDFWindowsFormData は、現在の THotPDF グラフからネイティブの認証付き FDF/XFDF エンジンへの Windows ブリッジを提供します

宣言

constructor Create(Document: THotPDF; OriginalSource: TStream;
  const Password: AnsiString; const Limits: THPDFWindowsFormDataLimits;
  Checkpoint: TNotifyEvent = nil);
procedure SetSignaturePolicyOptions(const Options: THPDFHeadlessCMSOptions);
function ExportData(Format: THPDFHeadlessFormDataFormat;
  const Options: THPDFHeadlessFormDataOptions): TBytes;
procedure ImportData(const Bytes: TBytes; Format: THPDFHeadlessFormDataFormat;
  const Fonts: THPDFHeadlessRichTextFonts;
  const AppearanceOptions: THPDFHeadlessTextAppearanceOptions;
  const Options: THPDFHeadlessFormDataOptions; const Password: AnsiString);
procedure ImportDataWithFamilies(const Bytes: TBytes;
  Format: THPDFHeadlessFormDataFormat; const Families: THPDFHeadlessRichTextFontFamilies;
  const AppearanceOptions: THPDFHeadlessTextAppearanceOptions;
  const Options: THPDFHeadlessFormDataOptions; const Password: AnsiString);
procedure FillTypedData(const Updates: THPDFHeadlessRichTextFieldUpdates;
  const Options: THPDFHeadlessFormDataOptions; const Password: AnsiString);
function PreparedFieldCount: Integer;
procedure GetPreparedField(Index: Integer; out Name, Value: UnicodeString;
  out FieldType: Integer);
procedure WritePreparedPDF(Destination: TStream);
procedure TakeCandidate(out Document: THotPDF;
  out Source: THPDFWindowsFormDataSource);
property ChangedFields: Integer;
property CancellationToken: THPDFCancellationToken;

所有権とポリシー

Document、OriginalSource、Checkpoint は破棄まで借用されます。OriginalSource はドキュメントがロードした元リビジョンと正確に対応しなければなりません。コンストラクターはプライベートな元ソースをコピーして封印し、AES クレデンシャルを認証し、別のプライベートソースに実際の保留グラフを準備します

ネイティブエンジンは既存の署名完全性と ESS 証明書バインディング、DocMDP 権限、FieldMDP ロック、フィールドの読み取り専用フラグを検査します。許可された P2/P3 更新は、元の署名バイトを保ったまま正規のアピアランスを再生成します

必須のトラスト、タイムスタンプ、署名付き失効の各検査は SetSignaturePolicyOptions で設定できます。通常の完全性検査は、未指定のビジネスルートへのトラストを意味しません

ImportData は 1 つの候補 PDF と、別途ロードした 1 つの THotPDF を準備します。借用ドキュメントは変更しません。意味的に変わらないインポートでも、正確な現在リビジョンをコピーする前に署名付きポリシーを認証します

WritePreparedPDF は上限付き候補バイトを指定ストリームへコピーします。TakeCandidate の前に、必須の PDF と result コールバックをすべて成功させてください。失敗やキャンセルはトランザクションの破棄を意味します

TakeCandidate は THotPDF とその THPDFWindowsFormDataSource の両方の所有権を移します。ソースを破棄する前にドキュメントを破棄してください。候補はトランザクションのキャンセルトークンを保持しません

THPDFWindowsFormDataSource は排他的に作成された一時ファイルを所有します。Seal はそれをフラッシュして読み取り専用で開き直し、破棄時にファイルを閉じて削除します。ソースコールバックは所有するソースより長く生きません

ExportAnnotations と ImportAnnotations は マップ済み注釈 XFDF 交換を実装します。マップ済み XFDF インポートの追加数は ChangedAnnotations が報告し、ChangedFields と同じ準備済み変更カウンタを使います

上限

FillTypedData は、RV デコードの往復なしに、混合スカラーフィールドと元の型付きリッチ run を同じ候補の中で準備します。準備済みフィールドのアクセッサは実際の結果候補を読み取ります

ImportDataWithFamilies は、実際のスタイルプログラムと同じ認証付き候補ライフサイクルで、1〜16 の名前付きファミリーを選択します。元の ImportData メソッドは単一ファミリーの動作を保ちます

THPDFWindowsFormDataLimits.Default は MaxWorkingBytes を 256 MiB、MaxOutputBytes を 128 MiB、MaxObjects を 100000、MaxPages を 10000 に設定します。作業容量は 1 MiB 以上、その他の容量はすべて正でなければなりません

CancellationToken は借用であり、トランザクション破棄までしか有効ではありません。ネイティブ解析、リッチ XML デコード、ポリシー検証、コピーの間、元ドキュメントの操作トークンと Checkpoint をポーリングします

この Windows クラスはモダンな Delphi、C++Builder、Windows FPC で利用できます。ネイティブ Linux は THPDFHeadlessDocument を直接使います

関連トピック

Windows FDF/XFDF 交換、現在のグラフ準備、ネイティブフォームデータ

FDF 注釈グラフ

ExportAnnotationsFDF は注釈数を返し、有界なバイナリ FDF を Bytes に書き込みます。ImportAnnotationsFDF は THPDFFDFOptions を使って候補を準備します

FDF プロファイルは、供給された外観リソースと共有間接オブジェクトを保持します。同じページ上で一致する NM 値が、置き換え対象の既存注釈を選択します

FDF メソッドは、同じ借用ドキュメント所有権、認証済みポリシー、準備済み候補ライフサイクルを使います。ChangedAnnotations は実際の置き換えと追加を数え、等価なインポートは正確な現在リビジョンを保持します

注釈削除

RemoveAnnotations は、依存する popup と返信を含む正確なページと NM の削除を、同じ候補ライフサイクルで準備します。削除はすべて ChangedAnnotations が 1 回ずつ報告します

TakeCandidate の前に PDF と result データを公開してください。失敗しても借用ドキュメントとソースは変更されません