PDFium Delphi Component Docs

TPdfDocumentSearch třída

Jednotka: PDFium
Protéká textové shody dokumentem dopředu nebo dozadu a nativní handle si drží jen pro jednu stránku

Metody

MethodDescription
CreateInicializuje hledání vlastněné dokumentem s textem, volbami, počáteční stránkou, směrem a tokenem zrušení
DestroyZavře držené nativní vyhledávací handle a odpojí se od vlastnícího dokumentu
Next(out Match: TPdfDocumentSearchResult): BooleanVrací další shodu nebo False po dokončení, zrušení či zavření vlastnícího dokumentu

Vlastnosti

PropertyTypeDescription
CurrentPageIntegerAktuálně prohledávaná stránka číslovaná od jedničky
DirectionTPdfDocumentSearchDirectionPrůchod stránkami a shodami dopředu nebo dozadu
FinishedBooleanZda už žádný výsledek nemůže vzniknout
CancelledBooleanZda kooperativní zrušení hledání ukončilo
MatchCountUInt64Počet už vrácených shod

TPdfDocumentSearchResult

FieldTypeDescription
PageNumberIntegerStránka obsahující shodu, číslovaná od jedničky
StartIndexIntegerNulový index znaku na nativní textové stránce
CountIntegerPočet znaků nativní textové stránky ve shodě
TextWStringText Unicode extrahovaný ze shodného rozsahu
RectanglesTPdfRectanglesJeden nebo více sloučených obdélníků v prostoru stránky PDF pro zvýraznění

Životnost a souběžný přístup

Hledání vlastní volající a musí jej uvolnit. Vlastnící dokument sleduje živá hledání jen proto, aby mohl před uvolněním dokumentu zavřít jejich nativní handle

Volání do vlastnícího dokumentu sdílí jeho zámek PDFia. Jednu instanci hledání musí dál posouvat a uvolňovat stále jeden koordinovaný volající a úpravy dokumentu se nesmí překrývat s běžícím hledáním

Viz také

TPdf.CreateDocumentSearch, TPdf.FindFirst