THotPDF.RegisterCustomStreamFilter
以正規化後的 PDF filter 名稱保留應用程式自訂的解碼器
宣告
function RegisterCustomStreamFilter(
const CustomFilter: IHPDFCustomStreamFilter;
ReplaceExisting: Boolean = False): Boolean;參數
CustomFilter 提供名稱、mode、seek 合約與解碼器實作
ReplaceExisting 允許在正規化名稱已存在時進行原子替換
傳回值
插入或替換成功後傳回 True；停用替換時遇到重複名稱則傳回 False
使用說明
- nil 介面、不合法的 PDF 名稱、內建名稱，以及超過 64 筆的 registry 都會擲出參數或範圍例外
- 名稱比對不分大小寫，並忽略單一的前置斜線
- registry 會保留該介面，直到被替換、移除、清空或文件銷毀為止
- 並行解碼查詢會先取得介面快照，再釋放 registry 鎖