THPDFWindowsFormDataTransaction.RemoveAnnotations 方法

procedure RemoveAnnotations(
  const Identities: array of THPDFHeadlessAnnotationIdentity;
  const Options: THPDFHeadlessAnnotationRemovalOptions;
  const Password: AnsiString);

透過原生驗證引擎準備一個移除候選,不變更交易借用的 THotPDF 文件

交易建構時必須帶有與已載入文件對應的實際原始來源,以及驗證加密輸入所需的密碼

ChangedAnnotations 回報移除數,包括級聯依賴;計數器使用交易既有的準備變更儲存

準備之後,WritePreparedPDF 把有界候選複製到目的地串流;每個必需的 PDF 與結果發佈都成功之後才呼叫 TakeCandidate

TakeCandidate 移交新的 THotPDF 及其擁有的 THPDFWindowsFormDataSource;先銷毀文件再銷毀其來源

失敗或取消意味著丟棄交易並保留借用的文件與來源;已有準備候選的交易拒絕再次準備

零移除時輸出是精確的目前準備修訂,包括交易所代表的待處理已載入文件狀態;如果呼叫端有未儲存變更,則不一定是原始磁碟檔案

限制與識別

頁面與名稱選擇、依賴級聯、歧義檢查與 Widget 邊界遵循原生註解移除

明確提供的取消權杖必須是交易的權杖;交易把 MaxWorkingBytes 限制在其工作容量的一半,把 MaxAnnotations 限制在其物件容量

方法保留正容量檢查、加密註解權限與經驗證的簽章政策准入;密碼不是授權繞過

所有權與生命週期細節見一般 Windows 移除與 THPDFWindowsFormDataTransaction