SetDeterministicDocumentID

Propriedades de documentos, otimização

Descrição

Ativa ou desativa identificadores de ficheiro do trailer reproduzíveis, derivados de uma semente explícita ou de conteúdo serializado normalizado

Sintaxe

Delphi

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

Parâmetros

Enable	Passe `1` para derivar o identificador de ficheiro do trailer de uma semente explícita ou do conteúdo normalizado do documento, ou `0` para restaurar o identificador predefinido derivado da hora

Valores devolvidos

0	Valor de parâmetro inválido
1	Definição aplicada com êxito

Observações

Quando ativado, a próxima gravação completa não encriptada deriva o /ID do trailer da semente fornecida com SetDocumentIDSeed. Sem uma semente explícita, o escritor faz passar o cabeçalho e o corpo do documento serializados por SHA-256, normaliza os identificadores de recursos gerados e os UUID de instância XMP, e usa os primeiros 16 bytes do resumo para ambas as entradas da matriz /ID inicial. Os dados de referências cruzadas, os desvios do trailer e qualquer /ID de trailer anterior são excluídos, pelo que alterações de páginas, recursos, anexos e metadados afetam o identificador, enquanto os desvios de disposição nãoO identificador é renovado apenas em gravações completas. As atualizações incrementais nunca reescrevem o identificador permanente, e os documentos encriptados mantêm o respetivo identificador existente porque a primeira entrada de

/ID participa na derivação da chave de encriptação. As datas automáticas e outros metadados voláteis do utilizador permanecem conteúdo; defina-os explicitamente quando dois documentos gerados de forma independente têm de receber o mesmo identificador derivado do conteúdo

Exemplo

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

Consulte também

GetDeterministicDocumentID, SetDocumentIDSeed, GetDocumentFileID