TPDFlibSearchOption
資料類型
描述
TPDFlibSearchOption 定義文字搜尋規則，包括大小寫敏感、單字邊界匹配、變音符號摺疊、萬用字元匹配、跨行匹配、正規等價、字簇邊界與替換樣式保留
語法
Delphi
type TPDFlibSearchOption = (soCaseSensitive, soWholeWord, soDiacriticInsensitive, soWildcards, soAcrossLines, soPreserveStyle, soCanonicalEquivalent, soGraphemeClusters);參數
| soCaseSensitive | 查詢比對必須遵循大小寫字元配置（大寫和小寫被視為不同） |
|---|---|
| soWholeWord | 僅在查詢字詞被非單字字元（空格、標點符號等）包圍時才符合該字詞 |
| soDiacriticInsensitive | 比較前先把查詢與區塊文字透過 1:1 Unicode 摺疊（大小寫加上拉丁/希臘/西里爾聲調符號去除），一般字母因此能對上帶聲調的版本。搭配 soCaseSensitive 可保留大小寫差異，同時仍摺疊聲調符號。 |
| soWildcards | 把查詢中的 * 與 ? 當成序列與單字元萬用字元。 |
| soAcrossLines | 讓查詢跨越多行區塊內的斷行；每個斷行折疊成一個可比對的空格。 |
| soPreserveStyle | 只影響 SearchAndReplaceText：替換文字繼承命中區塊的文字大小與顏色，而不是呼叫端目前的設定。 |
| soCanonicalEquivalent | 匹配前把查詢與擷取文字正規化為正規分解，NFC 與 NFD 表示因此可等同比較，而命中偏移與長度仍對應原始區塊文字。 |
| soGraphemeClusters | 要求匹配的起點與終點落在擴充字簇邊界上，保護代理對、組合序列、emoji ZWJ 序列、區域指示旗標與印度語系連結字。搭配 soWildcards 時，? 會消耗一個完整字簇。 |