原生註解移除

按從零開始的頁面索引與精確的 Unicode NM 值移除既有頁面註解,同時保留原始 PDF 修訂並準備單獨的增量輸出

原生入口是 THPDFHeadlessDocument.SaveAnnotationRemovalsToFile;一般 Windows 文件使用 THPDFWindowsFormDataTransaction.RemoveAnnotations

識別與依賴

每個識別包含有效的頁面索引與非空名稱;比對在解碼 PDF 文字字串後區分大小寫,不做 Unicode 正規化,也不與顯示文字比對

不同頁面上的相同名稱識別不同註解;所選頁面上名稱不存在時是 no-op

移除註解也會移除其 popup 與依賴它的回覆,包括巢狀回覆與 popup 依賴;已造訪集合讓依賴環有界,每個被移除的註解只給回傳計數貢獻一次

只移除 popup 時保留其擁有者並清除擁有者的 Popup 項目;無關的註解保留其原始順序與資料

重複的請求識別、同一頁面上有歧義的請求名稱,或被多個頁面陣列成員共用的註解字典都會在發佈前導致失敗

發佈與安全

原生方法在成功與失敗時都保持已載入文件不變;載入產生的 PDF 以採用移除結果

發佈使用準備好的檔案與原子目的地替換;準備失敗或取消時保留現有目的地,且目的地不得是已載入來源的別名

零移除發佈目前來源修訂的精確副本;對結果文件重複同一移除回傳零並保留其位元組

增量修訂從目前頁面圖形移除註解,同時保留更早的位元組與修訂;此操作不是安全抹除或塗銷,被刪除的內容可能仍可從檔案歷史復原

權限與資源限制

實際移除要求加密輸入有經驗證的註解權限、簽章輸入有簽章政策准入;成功開啟加密 PDF 本身並不授予變更註解的權限

經驗證的 P1 與 P2 拒絕註解變更;獲准的 P3 更新保留原始簽章位元組,簽章完整性與憑證繫結檢查會套用於實際文件

當這些檢查屬於應用程式安全需求時,明確設定所需的憑證信任、時間戳記與撤銷政策

移除選項限制註解計數、操作工作量、名稱儲存與工作記憶體,合作式取消與文件或交易共用

目前邊界

被選中的 Widget,或經移除依賴到達的 Widget 會被拒絕,因為移除表單欄位需要 AcroForm 欄位樹交易;此 API 不刪除欄位,也不悄悄分離其 widget

該操作不執行註解 action 或腳本,也不把移除解釋為套用 Redact 註解

annotations.remove、明確的輸入 IO 以及獨立的 PDF、結果與 context 提交階段見 JSON 與 callback 操作