Page Propriété

Page expose le handle PDFium FPDF_PAGE brut lié à la page actuellement active. Le handle est alloué quand PageNumber est défini (ou quand Active passe à True) et est maintenu en vie pendant toute la durée de vie de cette liaison de page. C’est le même handle que l’API C de PDFium attend pour chaque appel FPDFPage_*, FPDF_RenderPage*, annotation, flux de contenu et widget de formulaire

Le handle n’est valide que tant que Active vaut True et qu’un PageNumber valide est défini. Assigner un nouveau PageNumber, appeler ReloadPage ou ramener Active à False détruit le handle existant et (dans les deux premiers cas) en crée un nouveau. N’appelez pas FPDF_ClosePage sur ce handle — le composant en possède la durée de vie et le libérera automatiquement

Page est une propriété avancée, utile quand vous appelez des API PDFium que PDFium Delphi Component n’a pas encore enveloppées — par exemple régénération personnalisée de flux d’apparence, suivi d’objets de page ou réglages de bas niveau de l’extraction de texte. La plupart des appelants préféreront les propriétés de haut niveau (PageWidth, PageHeight, RenderToBitmap, Annotation, etc.) qui gèrent déjà le handle correctement

• Renvoie nil lorsqu’aucune page n’est active. Vérifiez toujours avant de passer le handle à une fonction PDFium
• Les handles de page ne sont pas thread-safe dans PDFium. Utilisez la page uniquement depuis le thread qui possède le Document parent
• Combinez avec Document lors de l’appel d’API PDFium qui prennent les deux handles — par ex. FPDFPage_Delete(Pdf.Document, Pdf.PageNumber - 1)