THotPDF.RegisterCustomStreamFilter
以规范化后的 PDF filter 名称保留应用自定义的解码器
声明
function RegisterCustomStreamFilter(
const CustomFilter: IHPDFCustomStreamFilter;
ReplaceExisting: Boolean = False): Boolean;
参数
CustomFilter 提供名称、模式、seek 约定和解码器实现
规范化后的名称已存在时,ReplaceExisting 允许原子替换
返回值
插入或替换之后返回 True;名称重复且未启用替换时返回 False
使用说明
- 接口为 nil、PDF 名称无效、名称与内置名称冲突,或注册表条目超过 64 个时,会抛出参数或范围异常
- 名称匹配不区分大小写,并忽略一个开头的斜杠
- 注册表会一直持有该接口,直到被替换、移除、清空,或文档被销毁
- 并发的解码查找会先取得接口快照,再释放注册表锁