AddTextMarkupFromSearchHits

Annotationer og hotspot-links

Beskrivelse

Tilføjer én tekstmarkeringsannotering pr. rektangel i Hits og omdanner dermed direkte ethvert træfarray returneret af SearchText, SearchTextEach, SearchTextBatch eller GetTextInAreaEx til markeringsannoteringer uden en manuel løkke over AddTextMarkupAnnotation

For hvert resultat springes et rektangel over, hvis Page ligger uden for dokumentets sideinterval, eller hvis Right/Bottom ikke er større end Left/Top. Hvert resterende rektangel vælger midlertidigt resultatets side, før annotationen tilføjes; den side, der var valgt ved kaldets start, gendannes altid før returnering, også ved resultater over flere sider

Syntaks

Delphi

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

Parametre

MarkupType1 = Fremhævning, 2 = Understregning, 3 = Bølget understregning, 4 = Gennemstregning
HitsSøgeresultater, der skal omdannes til annoteringer, typisk produceret af SearchText, SearchTextEach, SearchTextBatch eller GetTextInAreaEx

Returværdier

Antallet af annotationer, der faktisk blev oprettet. Resultater med en side uden for intervallet eller et degenereret rektangel springes over og tæller ikke med. Returnerer 0 uden at ændre det aktuelle sidevalg, når MarkupType ligger uden for 1–4, intet dokument er valgt, eller Hits er tomt

Bemærkninger

Brug i stedet HighlightTextSearchHits, når de træf, der skal markeres, allerede bevares af en aktiv BeginTextSearch-session. Indstil SearchContextChars før søgning for også at indfange omgivende tekst for hvert træf til inspektion eller logning før markering

Se også

AddTextMarkupAnnotation, HighlightTextSearchHits, SearchText, SearchTextEach, SearchTextBatch, TPDFlibSearchHit