Page Eigenschaft

Page legt das rohe PDFium-FPDF_PAGE-Handle offen, das an die aktuell aktive Seite gebunden ist. Das Handle wird allokiert, wenn PageNumber gesetzt wird (oder wenn Active auf True wechselt) und bleibt für die Lebensdauer dieser Seiten-Bindung am Leben. Es ist dasselbe Handle, das PDFiums C-API bei jedem FPDFPage_*-, FPDF_RenderPage*-, Annotations-, Content- Stream- und Formular-Widget-Aufruf erwartet

Das Handle ist nur gültig, solange Active True ist und eine gültige PageNumber gesetzt ist. Eine neue PageNumber zuweisen, ReloadPage aufrufen oder Active auf False zurücksetzen zerstört das vorhandene Handle und erzeugt (in den ersten beiden Fällen) ein neues. Rufen Sie nicht FPDF_ClosePage auf diesem Handle auf — die Komponente besitzt die Lebensdauer und baut es automatisch ab

Page ist eine Fortgeschrittenen-Eigenschaft, nützlich beim Aufruf von PDFium-APIs, die PDFium Delphi Component noch nicht wrappt — etwa eigene Appearance-Stream-Regeneration, Seitenobjekt- Buchhaltung oder Low-Level-Tuning der Textextraktion. Die meisten Aufrufer fahren mit den hochsprachlichen Eigenschaften (PageWidth, PageHeight, RenderToBitmap, Annotation usw.) besser, die das Handle bereits korrekt verwalten

• Liefert nil, wenn keine Seite aktiv ist. Immer vorher prüfen, bevor das Handle an eine PDFium-Funktion durchgereicht wird
• Page-Handles sind in PDFium nicht threadsafe. Verwenden Sie die Seite nur aus dem Thread, dem das übergeordnete Document gehört
• Mit Document kombinieren, wenn Sie PDFium-APIs aufrufen, die beide Handles erwarten — etwa FPDFPage_Delete(Pdf.Document, Pdf.PageNumber - 1)