FontHandle property

Mengembalikan handle FPDF_FONT native dari font yang dipakai oleh sebuah objek halaman. Handle memberi pemanggil tingkat lanjut akses langsung ke API font PDFium yang belum dibungkus oleh komponen

FontHandle mengembalikan pointer font PDFium mentah (FPDF_FONT) yang terkait dengan objek halaman teks pada indeks yang diberikan. Secara internal nilai adalah apa yang dikembalikan PDFium dari FPDFTextObj_GetFont; sebagian besar properti Font* lainnya pada TPdf — FontAscent, FontDescent, FontFamilyName, FontBaseName, FontIsEmbedded, FontItalicAngle, FontWeight, FontData — adalah pembungkus praktis yang dibangun di atasnya

Indeks adalah indeks objek-halaman berbasis-0 dalam rentang 0..ObjectCount - 1. Hanya objek bertipe teks yang membawa font; untuk objek gambar, path, atau shading panggilan mengembalikan nil. Halaman harus aktif sebelum membaca properti

Handle yang dikembalikan dimiliki oleh PDFium dan tetap valid hanya selama halaman saat ini dimuat. Jangan membebaskannya, jangan menyimpannya melintasi pergantian halaman, dan jangan memanggil API PDFium destruktif terhadapnya — perlakukan sebagai token opaque hanya-baca

• Pointer yang dikembalikan menjadi tidak valid segera setelah halaman dibongkar (mis. ketika PageNumber berubah) — jangan pernah menyimpannya ke cache
• Selalu uji terhadap nil sebelum meneruskan handle ke import FPDFFont_* mentah
• Properti ini adalah jembatan ke API PDFium yang belum memiliki pembungkus Pascal, mis. FPDFFont_GetFlags atau FPDFFont_GetFontBBox
• Dua objek halaman yang berbeda mungkin berbagi handle yang sama ketika mereka mereferensikan kamus font yang sama dalam PDF
• Membaca properti menyematkan font yang mendasari selama masa pakai panggilan; PDFium tidak melakukan reference-count handle, jadi rencanakan pekerjaan Anda sesuai itu

FontFamilyName, FontBaseName, FontIsEmbedded, FontData, ObjectCount, ObjectType