PDFium Delphi Component 文件

TPdfDocumentSearch 類別

單元: PDFium
在整份文件間以前向或後向方式串流處理文字符合項,並僅針對單一頁面保留原生控制代碼

Methods

MethodDescription
Create以文字、選項、起始頁面、方向與取消權杖初始化文件擁有的搜尋
Destroy關閉保留的原生搜尋控制代碼,並與擁有者文件中斷連結
Next(out Match: TPdfDocumentSearchResult): Boolean傳回下一個符合項;在完成、取消或擁有者文件關閉之後傳回 False

Properties

PropertyTypeDescription
CurrentPageInteger目前正在搜尋的頁面(以一為基底)
DirectionTPdfDocumentSearchDirection向前或向後的頁面與符合項走訪
FinishedBoolean是否已無法產生進一步的結果
CancelledBoolean合作式取消是否已結束搜尋
MatchCountUInt64已傳回的符合項數量

TPdfDocumentSearchResult

FieldTypeDescription
PageNumberInteger包含符合項的頁面(以一為基底)
StartIndexInteger原生文字頁字元索引(以零為基底)
CountInteger符合項中的原生文字頁字元數
TextWString從符合範圍擷取的 Unicode 文字
RectanglesTPdfRectangles一或多個合併後用於高亮顯示的 PDF 頁面空間矩形

生命週期與並行

搜尋由呼叫端擁有且必須自行釋放。擁有者文件只追蹤存續中的搜尋,以便在文件卸載之前關閉其原生控制代碼

對擁有者文件的呼叫會共用其 PDFium 鎖定。單一搜尋執行個體仍必須由單一協調的呼叫端推進並釋放,且文件編輯不得與作用中的搜尋重疊

See Also

TPdf.CreateDocumentSearch, TPdf.FindFirst