THPDFHeadlessRenderAccess
Der Record in HPDFHeadlessRenderAccess wird von THPDFHeadlessDocument.GetRenderAccess(PageIndex) zurückgegeben und gewährt seriellen schreibgeschützten Zugriff auf den aktuellen Dokumentgraphen
Das besitzende Dokument muss während der gesamten Nutzung geladen und unverändert bleiben; Pointer, Ressourcen-Dictionaries und Callback-Ergebnisse sind ausgeliehen, und Aufrufer dürfen sie weder freigeben noch verändern
| Feld | Vertrag |
|---|---|
Context | Opaker Dokument-Pointer, unverändert an jeden Callback übergeben |
PageDictionary, PageResources | Aufgelöstes Page-Dictionary und geerbtes Ressourcen-Dictionary |
Resolve: THPDFHeadlessRenderResolve | Löst ein ausgeliehenes Objekt über die bestehenden xref-, Object-Stream- und Security-Pfade auf |
ReadStream: THPDFHeadlessRenderReadStream | Liefert dekodierte Bytes mit dem gelieferten Maximum, angewendet vor dem Dekodieren, gekappt am Dokumentbudget |
ReadImageBytes: THPDFHeadlessRenderReadImage | Authentifiziert und entschlüsselt einen Bildstream, dekodiert begrenzte Präfix-Filter und liefert entweder dekodierte Samples oder die finale JPEG-, JPEG 2000-, CCITT- oder JBIG2-Payload samt ihrem terminalen Filternamen und ausgeliehenem DecodeParms-Dictionary |
FontResolver: THPDFHeadlessRenderFontResolver | Erzeugt ein Interface zum bestehenden Ressourcen-Font-Decoder |
RequireExtractionPermission: THPDFHeadlessRenderPermission | Prüft Abbruch und authentifizierte Extraktionsberechtigung |
RequireOutputPath: THPDFHeadlessRenderOutputPath | Prüft Abbruch und weist Quellaliase über kanonischen Pfad und physische Dateiidentität zurück, ohne eine Datei anzulegen |
CancellationToken | Ausgeliehenes aufruferseitiges Dokument-Abbruch-Token |
MaxDecodedBytes, MaxDepth | Obergrenzen, geerbt aus den Dokumentoptionen |
CatalogDictionary: THPDFDictionaryObject leiht den aufgelösten Catalog für die Optional-Content-Konfiguration; nil bedeutet, dass kein Catalog geliefert wurde und Optional-Content-Strukturen keinen Sichtbarkeitseffekt haben
ResolveOptional: THPDFHeadlessRenderResolve löst optionale Gruppenmitgliedschaften auf und liefert nil für fehlende, gelöschte oder veraltete Generation-Referenzen; gültige lebende Objekte behalten normale Parsing-, Object-Stream-, Security-, Abbruch- und Tiefenprüfungen, und ihre Fehler propagieren
Initialisieren Sie manuell zusammengesetzte Access-Records mit Default(THPDFHeadlessRenderAccess), bevor Sie Callbacks zuweisen; ein nil-ResolveOptional nutzt den gewöhnlichen Resolver, und ein nil-Catalog bewahrt das Rendering ohne Optional-Content-Konfiguration
Output-Renderer müssen RequireOutputPath(Context, FileName) aufrufen, bevor sie eine Datei anlegen, und ihre eigenen Staging-, Veröffentlichungs- und Zielbudget-Policys anwenden
Lifetime: IHPDFHeadlessRenderLifetime behält eine Graph-Lifetime-Lease bei; nil bleibt für statisches Rendering gültig, während explizite Viewer-Zustände eine gültige Lease verlangen und abgelaufenen Zugriff vor dem Aufruf von Callbacks zurückweisen
Eine View ist ungültig, nachdem das besitzende Dokument geschlossen, neu geladen, verändert oder zerstört wurde