THPDFHeadlessRenderAccess
Il record in HPDFHeadlessRenderAccess è restituito da THPDFHeadlessDocument.GetRenderAccess(PageIndex) per l'accesso serial read-only al grafo documento corrente
Il documento proprietario deve restare caricato e invariato per tutto l'uso; puntatori, dizionari risorsa e risultati callback sono presi in prestito e i chiamanti non devono liberarli né mutarli
| Campo | Contratto |
|---|---|
Context | Puntatore documento opaco passato invariato a ogni callback |
PageDictionary, PageResources | Dizionario pagina risolto e dizionario risorse ereditato |
Resolve: THPDFHeadlessRenderResolve | Risolve un oggetto preso in prestito attraverso i consueti percorsi xref, object-stream e sicurezza |
ReadStream: THPDFHeadlessRenderReadStream | Restituisce byte decodificati con il massimo fornito applicato prima della decodifica, limitato dal budget del documento |
ReadImageBytes: THPDFHeadlessRenderReadImage | Autentica e decifra uno stream immagine, decodifica i filtri prefix limitati e restituisce sample decodificati oppure il payload finale JPEG, JPEG 2000, CCITT o JBIG2 insieme al nome del filtro terminale e al dizionario DecodeParms preso in prestito |
FontResolver: THPDFHeadlessRenderFontResolver | Crea un'interfaccia al decoder di font risorsa esistente |
RequireExtractionPermission: THPDFHeadlessRenderPermission | Controlla cancellazione e permesso di estrazione autenticato |
RequireOutputPath: THPDFHeadlessRenderOutputPath | Controlla la cancellazione e rifiuta alias della sorgente per percorso canonico e identità fisica del file senza creare un file |
CancellationToken | Cancellation token del documento di proprietà del chiamante, preso in prestito |
MaxDecodedBytes, MaxDepth | Limiti superiori ereditati dalle opzioni del documento |
CatalogDictionary: THPDFDictionaryObject presta il catalogo risolto per la configurazione optional-content; nil significa che nessun catalogo è stato fornito e le strutture optional-content non hanno effetto sulla visibilità
ResolveOptional: THPDFHeadlessRenderResolve risolve le appartenenze a gruppi opzionali e restituisce nil per riferimenti mancanti, eliminati o di generazione stantia; gli oggetti vivi validi conservano i normali controlli di parsing, object-stream, sicurezza, cancellazione e profondità, e i loro errori si propagano
Inizializza i record di accesso assemblati manualmente con Default(THPDFHeadlessRenderAccess) prima di assegnare le callback; un ResolveOptional nil usa il resolver ordinario e un catalogo nil preserva il rendering senza configurazione optional-content
I renderer di output devono chiamare RequireOutputPath(Context, FileName) prima di creare un file e applicare le loro proprie policy di staging, pubblicazione e budget di destinazione
Lifetime: IHPDFHeadlessRenderLifetime trattiene un lease di durata del grafo; nil resta valido per il rendering statico, mentre gli stati viewer espliciti richiedono un lease valido e rifiutano accessi scaduti prima di invocare le callback
Una vista non è valida dopo che il documento proprietario è stato chiuso, ricaricato, modificato o distrutto