FontHandle Propriété

Returns the native FPDF_FONT handle de la police utilisée par un objet de page. Le handle donne aux appelants avancés un accès direct aux API de police PDFium non encapsulées par le composant

FontHandle returns the raw PDFium font pointer (FPDF_FONT) associé à l’objet texte de page à l’index fourni. En interne, la valeur correspond à ce que PDFium renvoie depuis FPDFTextObj_GetFont; most of the other Font* properties on TPdf — FontAscent, FontDescent, FontFamilyName, FontBaseName, FontIsEmbedded, FontItalicAngle, FontWeight, FontData — sont des wrappers de commodité construits au-dessus de lui

The index is a 0-based page-object index in the range 0..ObjectCount - 1. Seuls les objets de type texte portent une police; pour les objets image, chemin ou ombrage, l’appel renvoie nil. Une page doit être active avant de lire la propriété

Le handle renvoyé appartient à PDFium et n’est valide que tant que la page courante est chargée. Ne le libérez pas, ne le stockez pas à travers les changements de page, et n’appelez pas d’API PDFium destructrices dessus — traitez-le comme un jeton opaque en lecture seule

• Le pointeur renvoyé devient invalide dès que la page est déchargée (par ex. lorsque PageNumber change) — ne le mettez jamais en cache
• Testez toujours nil avant de passer le handle à un import FPDFFont_* brut
• Cette propriété est le pont vers les API PDFium qui n’ont pas encore d’enveloppe Pascal, par ex. FPDFFont_GetFlags ou FPDFFont_GetFontBBox
• Deux objets de page différents peuvent partager le même handle lorsqu’ils référencent le même dictionnaire de police dans le PDF
• Lire la propriété épingle la police sous-jacente pour la durée de l’appel ; PDFium ne compte pas les références du handle, donc planifiez votre travail en conséquence

FontFamilyName, FontBaseName, FontIsEmbedded, FontData, ObjectCount, ObjectType