SetDeterministicDocumentID

文件內容、最佳化

描述

啟用或停用衍生自明確種子或正規化序列化內容的可重現 trailer 檔案識別碼

語法

Delphi

Function TPDFlib.SetDeterministicDocumentID(Enable: Integer): Integer;

參數

Enable	傳入 `1` 以從明確種子或正規化的文件內容衍生 trailer 檔案識別碼，或傳入 `0` 以還原預設的時間衍生識別碼

傳回值

0	參數值無效
1	設定已成功套用

備註

/IDSetDocumentIDSeed 提供的種子衍生 trailer /ID；沒有明確種子時，寫入器會將序列化的標頭與文件主體串流經 SHA-256 運算，將產生的資源識別碼與 XMP 執行個體 UUID 正規化，並使用前 16 個摘要位元組作為初始 /ID 陣列的兩個項目。交叉參照資料、trailer 位移與任何先前的 trailer

/ID 都會被排除，因此頁面、資源、附件與中繼資料的變更會影響識別碼，而版面位移則不會識別碼只會在完整儲存時重新整理；增量更新絕不會改寫永久識別碼，而加密文件會保留其現有識別碼，因為第一個

範例

PDF.SetDeterministicDocumentID(1);
PDF.SetDocumentIDSeed('invoice-2026-07-0001');
PDF.DrawText(100, 100, 'Reproducible output');
PDF.SaveToFile('invoice.pdf'); // same seed, same trailer ID

另請參閱

GetDeterministicDocumentID, SetDocumentIDSeed, GetDocumentFileID