AddTextMarkupFromSearchHits

Annotations and hotspot links

Description

Lägger till en textmarkering-annotering per rektangel i Hits och gör vilken träffarray som helst som returnerats av SearchText, SearchTextEach, SearchTextBatch eller GetTextInAreaEx till markering-annoteringar direkt, utan manuell loop över AddTextMarkupAnnotation

För varje träff hoppas en rektangel vars Page ligger utanför dokumentets sidintervall eller vars Right/Bottom inte överskrider Left/Top över. Varje överlevande rektangel väljer tillfälligt träffens sida innan annoteringen läggs till; sidan som var vald när anropet började återställs alltid innan retur, även för träffar som spänner över flera sidor

Syntax

Delphi

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

Parameters

MarkupType	1 = Highlight, 2 = Underline, 3 = Squiggly, 4 = StrikeOut
Hits	Sökträffar som ska göras till annoteringar, typiskt producerade av `SearchText`, `SearchTextEach`, `SearchTextBatch` eller `GetTextInAreaEx`

Return values

Antalet annoteringar som faktiskt skapades. Träffar med en sida utanför intervallet eller en degenererad rektangel hoppas över och räknas inte. Returnerar 0 utan att ändra aktuellt sidval när MarkupType ligger utanför 1–4, inget dokument är valt, eller Hits är tom

Remarks

Använd i stället HighlightTextSearchHits när träffarna som ska markeras är de som en aktiv BeginTextSearch-session redan behåller. Sätt SearchContextChars före sökningen för att också fånga omgivande text på varje träff för inspektion eller loggning innan den markeras