ネイティブ注釈削除

0 起点のページインデックスと正確な Unicode NM 値によって既存のページ注釈を削除します。元の PDF リビジョンを保持し、別個のインクリメンタル出力を準備します

ネイティブのエントリポイントは THPDFHeadlessDocument.SaveAnnotationRemovalsToFile です。通常の Windows ドキュメントでは THPDFWindowsFormDataTransaction.RemoveAnnotations を使用します

識別と依存関係

各識別子は有効なページインデックスと空でない名前を含みます。照合は PDF テキスト文字列のデコード後に大文字小文字を区別し、Unicode 正規化や表示テキストとの照合は行いません

異なるページ上の同じ名前は別の注釈を識別します。選択ページに名前が存在しない場合は no-op です

注釈を削除すると、その popup と依存する返信も削除されます。ネストした返信や popup の依存関係を含みます。visited セットが依存サイクルを有限に保ち、削除された各注釈は返される件数に 1 回だけ計上されます

popup のみを削除した場合は所有者が保持され、所有者の Popup エントリがクリアされます。無関係な注釈は元の順序とデータを保持します

要求識別子の重複、1 ページ上の曖昧な要求名、複数のページ配列エントリで共有される注釈ディクショナリは、公開前に失敗します

ネイティブメソッドは成功時も失敗時もロード済みドキュメントを変更しません。削除を採用するには結果の PDF をロードしてください

公開は準備済みファイルと宛先のアトミック置換を使用します。準備の失敗やキャンセルは既存の宛先を保持し、宛先はロード済みソースのエイリアスであってはなりません

削除 0 件の場合、現在のソースリビジョンの正確なコピーが公開されます。結果のドキュメントに対して同じ削除を繰り返すと 0 を返し、バイトを保持します

インクリメンタルリビジョンは、古いバイトとリビジョンを保持しながら現在のページグラフから注釈を削除します。この操作はセキュア消去や redaction ではなく、削除されたコンテンツはファイル履歴から復元可能なまま残り得ます

実際の削除には、暗号化入力に対する認証済み注釈権限と、署名入力に対する署名ポリシーの許可が必要です。暗号化 PDF のオープンに成功しても、注釈変更の権限が与えられるわけではありません

認証済み認定 P1 と P2 は注釈変更を拒否します。許可された P3 更新は元の署名バイトを保持し、署名の整合性と証明書バインディング検査が実際のドキュメントに適用されます

それらの検査がアプリケーションのセキュリティ要件の一部である場合は、必要な証明書信頼、タイムスタンプ、失効ポリシーを明示的に設定してください

削除オプションは注釈数、操作作業、名前ストレージ、ワーキングメモリを制限し、ドキュメントまたはトランザクションと共有される協調的キャンセルを伴います

選択された Widget や削除依存関係を通じて到達した Widget は拒否されます。フォームフィールドの削除には AcroForm フィールドツリートランザクションが必要です。この API はフィールドを削除したり、その widget を黙って切り離したりしません

この操作は注釈アクションやスクリプトを実行せず、削除を Redact 注釈の適用として解釈しません

annotations.remove、明示的な入力 IO、PDF・結果・コンテキストの分離コミット段階については、JSON とコールバック操作を参照してください