AddTextMarkupFromSearchHits

Annotations and hotspot links

Mô tả

Thêm một chú thích text markup cho mỗi hình chữ nhật trong Hits, biến mọi mảng điểm trúng do SearchText, SearchTextEach, SearchTextBatch hay GetTextInAreaEx trả về thành chú thích markup ngay lập tức, không phải tự viết vòng lặp qua AddTextMarkupAnnotation

Với mỗi điểm trúng, một hình chữ nhật mà Page nằm ngoài dải trang tài liệu hoặc Right/Bottom không vượt Left/Top sẽ bị bỏ qua. Mỗi hình chữ nhật sống sót tạm thời chọn trang của điểm trúng trước khi thêm chú thích; trang đang chọn khi lời gọi bắt đầu luôn được khôi phục trước khi trả về, kể cả với các điểm trúng vắt qua nhiều trang

Cú pháp

Delphi

Function TPDFlib.AddTextMarkupFromSearchHits(MarkupType: Integer; Const Hits: Array Of TPDFlibSearchHit): Integer;

Tham số

MarkupType	1 = Highlight, 2 = Underline, 3 = Squiggly, 4 = StrikeOut
Hits	Search hits to turn into annotations, typically produced by `SearchText`, `SearchTextEach`, `SearchTextBatch` or `GetTextInAreaEx`

Giá trị trả về

Số chú thích thực sự được tạo. Các điểm trúng có trang ngoài khoảng hay hình chữ nhật suy biến bị bỏ qua và không đếm. Trả về 0 mà không đổi lựa chọn trang hiện tại khi MarkupType ngoài 1–4, không có tài liệu nào đang chọn, hay Hits rỗng

Remarks

Dùng HighlightTextSearchHits thay thế khi các điểm trúng cần đánh dấu là những điểm mà một phiên BeginTextSearch đang hoạt động đã giữ lại. Đặt SearchContextChars trước khi tìm kiếm để mỗi điểm trúng còn chụp thêm văn bản xung quanh, phục vụ xem hay ghi log trước khi đánh dấu

Xem thêm

AddTextMarkupAnnotation, HighlightTextSearchHits, SearchText, SearchTextEach, SearchTextBatch, TPDFlibSearchHit