THPDFHeadlessRenderAccess
O registo em HPDFHeadlessRenderAccess é devolvido por THPDFHeadlessDocument.GetRenderAccess(PageIndex) para acesso só de leitura em série ao grafo atual do documento
O documento proprietário tem de permanecer carregado e inalterado ao longo do uso; ponteiros, dicionários de recursos e resultados de callbacks são emprestados, e quem chama não os deve libertar nem mutar
| Campo | Contrato |
|---|---|
Context | Ponteiro opaco de documentos passado inalterado a todos os callbacks |
PageDictionary, PageResources | Dicionário resolvido de páginas e dicionário herdado de recursos |
Resolve: THPDFHeadlessRenderResolve | Resolve um objeto emprestado através dos caminhos existentes de xrefs, object streams e segurança |
ReadStream: THPDFHeadlessRenderReadStream | Devolve bytes descodificados com o máximo fornecido aplicado antes da descodificação, limitado pelo orçamento do documento |
ReadImageBytes: THPDFHeadlessRenderReadImage | Autentica e desencripta uma stream de imagens, descodifica filtros de prefixos delimitados e devolve amostras descodificadas ou o payload final JPEG, JPEG 2000, CCITT ou JBIG2 juntamente com o nome do filtro terminal dele e o dicionário emprestado de DecodeParms |
FontResolver: THPDFHeadlessRenderFontResolver | Cria uma interface para o descodificador existente de tipos de letra de recursos |
RequireExtractionPermission: THPDFHeadlessRenderPermission | Verifica cancelamento e permissão autenticada de extração |
RequireOutputPath: THPDFHeadlessRenderOutputPath | Verifica cancelamento e rejeita aliases da fonte por caminho canónico e identidade física de ficheiros sem criar um ficheiro |
CancellationToken | Token emprestado de cancelamento de documentos, próprio de quem chama |
MaxDecodedBytes, MaxDepth | Limites superiores herdados das opções do documento |
CatalogDictionary: THPDFDictionaryObject empresta o catalog resolvido para configuração de optional content; nil significa que nenhum catalog foi fornecido e que as estruturas de optional content não têm efeito de visibilidade
ResolveOptional: THPDFHeadlessRenderResolve resolve pertenças opcionais de grupos e devolve nil para referências em falta, eliminadas ou de gerações obsoletas; objetos vivos válidos mantêm o parsing normal deles, verificações de object streams, segurança, cancelamento e profundidade, e os erros deles propagam-se
Inicialize registos de acesso montados manualmente com Default(THPDFHeadlessRenderAccess) antes de atribuir callbacks; um ResolveOptional nil usa o resolver ordinário, e um catalog nil preserva a renderização sem configuração de optional content
Renderizadores de saída têm de chamar RequireOutputPath(Context, FileName) antes de criar um ficheiro e aplicar as políticas próprias deles de staging, publicação e orçamentos de destinos
Lifetime: IHPDFHeadlessRenderLifetime retém um lease de tempo de vida de grafos; nil permanece válido para renderização estática, enquanto estados explícitos de leitores exigem um lease válido e rejeitam acesso expirado antes de invocar callbacks
Uma vista é inválida depois de o documento proprietário ser fechado, recarregado, alterado ou destruído