AddTextMarkupFromSearchHits

التعليقات التوضيحية وروابط النقاط الفعالة

الوصف

يضيف تعليقًا توضيحيًا واحدًا من نوع وسْم نصي عن كل مستطيل في Hits، محولًا أي مصفوفة إصابات تُرجعها SearchText أو SearchTextEach أو SearchTextBatch أو GetTextInAreaEx مباشرةً إلى تعليقات وسْم دون حلقة يدوية على AddTextMarkupAnnotation

عن كل إصابة يُتخطى المستطيل الذي تكون قيمة Page له خارج مدى صفحات المستند أو التي لا تتجاوز Right/Bottom قيمة Left/Top. ويختار كل مستطيل ناجٍ صفحة الإصابة مؤقتًا قبل إضافة التعليق التوضيحي؛ وتُستعاد دائمًا الصفحة التي كانت محددة عند بدء الاستدعاء قبل العودة، حتى للإصابات الممتدة عبر صفحات متعددة

الصيغة

Delphi

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

المعاملات

قيم الإرجاع

عدد التعليقات التوضيحية المنشأة فعليًا. وتُتخطى الإصابات ذات الصفحة خارج النطاق أو المستطيل الشاذ ولا تُعدّ. وتُرجع 0 دون تغيير اختيار الصفحة الحالي عندما يكون MarkupType خارج 1–4 أو لا يوجد مستند محدد أو تكون Hits فارغة

ملاحظات

استخدم HighlightTextSearchHits بدلًا من ذلك عندما تكون الإصابات المطلوب وسمها تلك التي تحتفظ بها جلسة BeginTextSearch نشطة. اضبط SearchContextChars قبل البحث لالتقاط النص المحيط أيضًا عن كل إصابة للفحص أو التسجيل قبل وسمها

انظر أيضا

AddTextMarkupAnnotation, HighlightTextSearchHits, SearchText, SearchTextEach, SearchTextBatch, TPDFlibSearchHit