AddTextMarkupFromSearchHits

Anotaciones y enlaces de zonas interactivas

Descripción

Agrega una anotación de marcado de texto por rectángulo en Hits, convirtiendo directamente en anotaciones de marcado cualquier arreglo de coincidencias devuelto por SearchText, SearchTextEach, SearchTextBatch o GetTextInAreaEx, sin un ciclo manual sobre AddTextMarkupAnnotation

Para cada resultado, se omite un rectángulo cuyo Page está fuera del intervalo de páginas del documento o cuyo Right/Bottom no supera Left/Top. Cada rectángulo restante selecciona temporalmente la página del resultado antes de agregar la anotación; la página seleccionada al iniciar la llamada siempre se restaura antes de devolver el control, incluso para resultados que abarcan varias páginas

Sintaxis

Delphi

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

Parámetros

MarkupType1 = Resaltado, 2 = Subrayado, 3 = Ondulado, 4 = Tachado
HitsResultados de búsqueda que se convertirán en anotaciones, producidos normalmente por SearchText, SearchTextEach, SearchTextBatch o GetTextInAreaEx

Valores devueltos

El número de anotaciones realmente creadas Se omiten las coincidencias con una página fuera de rango o un rectángulo degenerado y no se cuentan Devuelve 0 sin cambiar la selección de página actual cuando MarkupType está fuera de 1–4, no hay documento seleccionado o Hits está vacío

Observaciones

Use HighlightTextSearchHits en su lugar cuando los aciertos que se marcarán sean los que ya conserva una sesión activa de BeginTextSearch. Establezca SearchContextChars antes de buscar para capturar también el texto circundante de cada acierto para inspección o registro antes de marcarlo

Véase también

AddTextMarkupAnnotation, HighlightTextSearchHits, SearchText, SearchTextEach, SearchTextBatch, TPDFlibSearchHit