PDFium Delphi Component Docs

GeneratePagedLayout metode

Komponen: TPdf  ·  Units: PDFium, FPdfLayout

Syntax

function GeneratePagedLayout(Layout: TPdfLayoutDocument; PagedPlan: TPdfLayoutPagedPlan; out Plan: TPdfLayoutPlan; AllowSignedDocument: Boolean = False): Boolean;

Description

Mengukur dan mem-pagination layout sembari menserialisasi setiap perintah ke storage yang dapat di-seek dan dimiliki atau direferensikan oleh PagedPlan

Setelah pengukuran, metode ini mematerialisasi satu array perintah halaman pada satu waktu, mengeluarkan halaman tersebut melalui API page-object native PDFium yang sama seperti GenerateLayout, melakukan flush, melepas array lokal, lalu melanjutkan ke halaman berikutnya

Storage and cache

Gunakan TFileStream, TMemoryStream, atau TPdfRandomAccessStore khusus; stream harus mendukung seek, read, write, resize, dan pemakaian eksklusif selama masa hidup paged plan

MaxCommandCount, MaxStorageBytes, MaxPageCommands, dan MaxSourceCount menolak plan yang berlebihan, sedangkan MaxCachedPages membatasi cache LRU internal dan boleh bernilai nol

CommandCount, StorageByteCount, counter cache, dan puncak okupansi memaparkan perilaku yang dapat diukur

Result

Plan.Commands sengaja dibiarkan kosong; pengaturan halaman, jumlah halaman, elemen semantik, jumlah konten, hasil pengukuran, dan total referensi halaman yang stabil tetap tersedia

PagedPlan.MaterializePage dapat memulihkan satu halaman lengkap nanti, termasuk body ditambah segmen header dan footer yang ditulis terpisah

Limitations and safety

Metode ini menghasilkan layout tanpa tag; gunakan GenerateTaggedLayout ketika command plan lengkap di memori dan post-processing structure-tree diperlukan

PDFium menahan dokumen sumber dan halaman nativenya sampai save atau close, sehingga API ini membatasi materialisasi command level tinggi, bukan memori dokumen PDFium

Dokumen PDF sumber atau TPdfLayoutCachedNode yang direferensikan harus hidup lebih lama daripada pembuatan dan materialisasi berikutnya, dan tujuan yang ditandatangani memerlukan otorisasi eksplisit

Kegagalan pengukuran atau emisi mengosongkan storage perintah yang belum selesai dan membatalkan setiap halaman yang ditambahkan oleh pemanggilan

See Also

GenerateLayout, GenerateTaggedLayout, FPdfLayout, Penyimpanan kerja akses acak