AddTextMarkupFromSearchHits

Jegyzetek és aktívterület-hivatkozások

Leírás

Minden Hits téglalaphoz egy szövegjelölő megjegyzést ad, így a SearchText, SearchTextEach, SearchTextBatch vagy GetTextInAreaEx által adott találattömb közvetlenül jelölő megjegyzésekké válik, a AddTextMarkupAnnotation fölötti kézi ciklus nélkül

Minden találatnál kihagyja azt a téglalapot, amelynek Page értéke kívül esik a dokumentum oldaltartományán, vagy amelynek Right/Bottom értéke nem nagyobb Left/Top értékénél. Minden megmaradó téglalap ideiglenesen kiválasztja a találat oldalát az annotáció hozzáadása előtt; a hívás kezdetekor kijelölt oldal mindig visszaáll a visszatérés előtt, még több oldalt átfogó találatok esetén is

Szintaxis

Delphi

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

Paraméterek

MarkupType1 = Kiemelés, 2 = Aláhúzás, 3 = Hullámos aláhúzás, 4 = Áthúzás
HitsMegjegyzésekké alakítandó keresési találatok, amelyeket rendszerint a SearchText, SearchTextEach, SearchTextBatch vagy a GetTextInAreaEx állít elő

Visszatérési értékek

A ténylegesen létrehozott jegyzetek száma. A tartományon kívüli oldalra vagy degenerált téglalapra vonatkozó találatok kimaradnak, és nem számítanak bele. 0-t ad vissza az aktuális oldalkijelölés módosítása nélkül, ha a MarkupType 1–4 tartományon kívül esik, nincs kijelölt dokumentum, vagy a Hits üres

Megjegyzések

Használja inkább a HighlightTextSearchHits metódust, ha a megjelölendő találatok egy aktív BeginTextSearch munkamenetben már megőrzött találatok. A keresés előtt állítsa be a SearchContextChars értékét, hogy a megjelölés előtt ellenőrzéshez vagy naplózáshoz minden találat környező szövege is rögzüljön

Lásd még

AddTextMarkupAnnotation, HighlightTextSearchHits, SearchText, SearchTextEach, SearchTextBatch, TPDFlibSearchHit