TextPage svojstvo

TextPage izlaže sirovu PDFium FPDF_TEXTPAGE ručku povezanu s trenutno učitanom stranicom. Ručka se stvara lijeno kad stranica postane aktivna i održava na životu tijekom cijelog životnog vijeka tog povezivanja sa stranicom; daje izravan pristup API-ju za izdvajanje teksta koji nudi PDFium (FPDFText_*) za pozivatelje kojima trebaju operacije koje nisu izložene svojstvima TPdf više razine — na primjer tekstualni nizovi na razini glifa, podaci o proredama, prilagođena semantika pretraživanja ili izvorne mape indeksa znakova u granični okvir

Ručka je valjana samo dok je Active True i dok je odabrana valjana stranica. Prebacivanje stranica (dodjeljivanje novog PageNumber ili poziv ReloadPage) uništava prethodnu ručku i stvara novu, pa nemojte pohranjivati ručku kroz promjene stranica. Komponenta je vlasnik ručke i otpustit će je tijekom rušenja stranice — ne pozivajte sami FPDFText_ClosePage na njoj

Ovo je napredno svojstvo. Većina pozivatelja trebala bi preferirati omotače više razine CharacterCount, Character[I], CharacterRectangle[I], Find / FindNext — oni već interno upravljaju životnim ciklusom FPDF_TEXTPAGE. Spustite se na sirovu ručku samo kad trebate PDFium API-je koje PDFium Delphi Component još nije izložio

• Vraća nil kad nijedna stranica nije aktivna. Uvijek provjerite ručku prije njezina prosljeđivanja PDFium-u
• Ručka odražava tok sadržaja stranice kako ga raščlanjuje PDFium — ne uključuje stanje pretraživanja iz FPDFText_FindStart; taj kontekst pretraživanja posjeduje se neovisno kroz svojstvo Find
• Pozivanje sirovih PDFium API-ja kroz ovu ručku zaobilazi slojeve predmemoriranja PDFium Delphi Componenta, pa intenzivna upotreba može pogoršati performanse u usporedbi s pristupnicima više razine