Headless 签名外观档位

向 THPDFHeadlessDocument.SetSignatureFieldAppearance 传入受支持的 ProfileName,即可选择一个实际由生产方定义的视觉配置

档位实际配置
HotPDF.StandardApproval11 pt 居中蓝色文本、4 pt 内边距、矩形边框、白色背景、单行文本
HotPDF.StandardCertification10 pt 左对齐黑色文本、5 pt 内边距、矩形边框、白色背景、多行换行、1.35 行距
HotPDF.Compact8 pt 右对齐黑色文本、1 pt 内边距、不绘制背景与边框、单行文本

caption 提供实际签名文本,TrueTypeFont 提供一个允许嵌入的字体;档位决定其视觉布局,而不是给调用方的任意选项贴标签

widget 几何与旋转仍属于文档的一部分,而档位对齐优先于继承的字段对齐提示

选择档位时,调用方的 MaxFontBytes、MaxObjectBytes、MaxGlyphs 与 CancellationToken 依然有效

HPDFSelectHeadlessSignatureAppearanceProfile 为需要在生成前检查配置选项的应用暴露同样的内置选择

种子要求与持久化

必需的签名种子 AppearanceFilter 值与当前已加载文档实例中实际应用的档位匹配

每个生成的 normal 外观流都按文档字符串加密策略记录 HotPDFAppearanceProfile,签名时会认证该流及其实际文本、字体和布局

加载已保存的文档会保留元数据但清空应用状态;当必需的种子点名某个档位时,签名前需重新应用选定的档位

用普通无名外观替换命名字外观会清空对应的应用状态

取消生成会保留先前的实际外观与档位,未知名称在生成前即失败