AddTextMarkupFromSearchHits
annotationها و hotspot linkها
توضیحات
بهازای هر مستطیل در Hits یک حاشیهنویسی نشانهگذاری متن اضافه میکند و هر آرایهٔ برخورد برگرداندهشده توسط SearchText، SearchTextEach، SearchTextBatch یا GetTextInAreaEx را بدون حلقهٔ دستی روی AddTextMarkupAnnotation مستقیماً به حاشیهنویسیهای نشانهگذاری تبدیل میکند
برای هر برخورد، مستطیلی که Page آن بیرون بازهٔ صفحات سند باشد یا Right/Bottom آن از Left/Top فراتر نرود رد میشود. هر مستطیل بازمانده قبل از افزودن حاشیهنویسی موقتاً صفحهٔ برخورد را انتخاب میکند؛ صفحهای که هنگام شروع فراخوانی انتخاب شده بود همیشه پیش از برگشتن بازگردانی میشود حتی برای برخوردهایی که چند صفحه را میپوشانند
نحو
Delphi
Function TPDFlib.AddTextMarkupFromSearchHits(MarkupType: Integer; Const Hits: Array Of TPDFlibSearchHit): Integer;پارامترها
| MarkupType | 1 = هایلایت، 2 = زیرخط، 3 = موجی، 4 = خطخورده |
|---|---|
| Hits | برخوردهای جستوجو برای تبدیل به حاشیهنویسی، معمولاً تولیدشده توسط SearchText، SearchTextEach، SearchTextBatch یا GetTextInAreaEx |
مقادیر بازگشتی
تعداد annotationهایی که واقعاً ایجاد شدهاند. hitهایی که صفحهشان خارج از محدوده است یا rectangle degenerate دارند نادیده گرفته میشوند و در شمارش نمیآیند. وقتی MarkupType خارج از بازه 1–4 باشد، هیچ سندی انتخاب نشده باشد یا Hits خالی باشد، مقدار 0 را بدون تغییر انتخاب فعلی صفحه برمیگرداند
ملاحظات
وقتی برخوردهایی که باید نشانهگذاری شوند همانهاییاند که نشست فعال BeginTextSearch از قبل نگه داشته بهجای آن از HighlightTextSearchHits استفاده کنید. برای گرفتن متن اطراف هر برخورد برای بررسی یا لاگ پیش از نشانهگذاری، پیش از جستوجو SearchContextChars را تنظیم کنید
همچنین ببینید
AddTextMarkupAnnotation, HighlightTextSearchHits, SearchText, SearchTextEach, SearchTextBatch, TPDFlibSearchHit