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