PDFium Delphi Component 文件

HighlightColor 屬性

元件: TPdfView  ·  單元: PDFium
由 HighlightSearchText 回傳的每一個符合項，都會在其上方繪製矩形；HighlightColor 就是這些矩形的填色。預設為 clYellow，並以 published 形式公開，方便應用程式自行調整主題色

Syntax

property HighlightColor: TColor;

Description

HighlightColor 是檢視器在為 HighlightSearchText 所找到的每一個符合項繪製搜尋結果遮罩時所使用的筆刷顏色。遮罩會在每次重繪時疊加在轉譯後的 PDF 頁面上方，因此反白會明顯跟隨捲動與縮放，而不需要重新執行搜尋

預設值為 clYellow — 這是所有主流 PDF 閱讀器在頁內尋找反白上通行的慣例。此屬性以 published 形式公開，讓應用程式能將顏色調整成符合自身 UI 色板，而無須子類化 TPdfView（泛黃閱讀器主題可用深琥珀色；深色模式檢視器可用柔和的青色）

HighlightColor 是此疊加層唯一的樣式選項 — 遮罩是文字後方的一層純色填色，刻意保持簡單，讓反白矩形永不遮蔽字形的反鋸齒。若要多色反白（每個符合項 / 每個查詢 / 每個頁面使用不同顏色），請改用自訂的 OnPaint 處理常式，而不要使用 HighlightSearchText

Remarks

Example

// Theme the highlight to match a dark reader UI
PdfView1.HighlightColor := $00FFFF66; // pale yellow
PdfView1.HighlightSearchText('invoice', False, True);

// Round-trip via the Object Inspector default
PdfView1.HighlightColor := clYellow;

See Also

HighlightSearchText, ClearHighlight, FindFirst