AddTextMarkupFromSearchHits

Annotazioni, collegamenti hotspot

Descrizione

Aggiunge un'annotazione di markup testuale per ciascun rettangolo in Hits, convertendo direttamente in annotazioni di markup qualsiasi matrice di risultati restituita da SearchText, SearchTextEach, SearchTextBatch o GetTextInAreaEx, senza un ciclo manuale su AddTextMarkupAnnotation

Per ogni occorrenza viene ignorato un rettangolo la cui Page è fuori dall'intervallo di pagine del documento o il cui Right/Bottom non supera Left/Top. Ogni rettangolo valido seleziona temporaneamente la pagina dell'occorrenza prima di aggiungere l'annotazione; prima del ritorno viene sempre ripristinata la pagina selezionata all'inizio della chiamata, anche per occorrenze su più pagine

Sintassi

Delphi

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

Parametri

Valori restituiti

Numero di annotazioni effettivamente create. Le occorrenze con una pagina fuori intervallo o un rettangolo degenere vengono ignorate e non conteggiate. Restituisce 0 senza modificare la selezione della pagina corrente quando MarkupType non è compreso tra 1–4, non è selezionato alcun documento oppure Hits è vuoto

Note

Usare invece HighlightTextSearchHits quando i risultati da contrassegnare sono già conservati da una sessione BeginTextSearch attiva. Impostare SearchContextChars prima della ricerca per acquisire anche il testo circostante di ogni risultato, da esaminare o registrare prima dell'applicazione del markup

Vedere anche

AddTextMarkupAnnotation, HighlightTextSearchHits, SearchText, SearchTextEach, SearchTextBatch, TPDFlibSearchHit