Método THotPDF.SetLoadedFreeTextPlainText

Convierte explícitamente una anotación FreeText cargada compatible en texto plano alineado a la izquierda y reconstruye su apariencia normal

Declaración

procedure SetLoadedFreeTextPlainText(PageIndex, AnnotationIndex: Integer;
  const AText: AnsiString; FontSize: Single = 12);

Unidad: HPDFDoc · Disponible desde la versión 2.753.0

Parámetros

• PageIndex: índice basado en cero de la página cargada
• AnnotationIndex: índice basado en cero de la anotación en esa página
• AText: caracteres ASCII imprimibles, con CR, LF o CR/LF para saltos de línea explícitos; los tabs, los demás caracteres de control y el texto no ASCII se rechazan
• FontSize: tamaño finito en puntos PDF, mayor que cero y de hasta 10,000, con 12 por defecto

Conversión de apariencia

El método usa texto Helvetica en negro y un borde rectangular negro, conserva el fondo en device color compatible y la geometría de borde sólido o discontinuo, y recorta el texto a un margen interno de dos puntos dentro del rectángulo de la anotación

Las líneas avanzan 1.2 veces el tamaño de la fuente; no hay ajuste de línea automático ni reducción para encajar, así que el texto que cae fuera del margen interno se recorta

La conversión reemplaza /AP, actualiza /Contents y /DA, pone /Q en cero y elimina /RC, /DS y /AS; el texto enriquecido, la selección de fuente, el color de texto, la alineación y los estados de apariencia anteriores se reemplazan de forma intencional

Los cambios de anotación, apariencia y página quedan registrados para el guardado incremental y el render cache de la página se invalida; el guardado por reescritura también conserva la nueva apariencia

Entrada admitida y errores

La anotación debe existir y tener el subtipo FreeText, con un rectángulo finito de más de cuatro puntos de ancho y de alto

Los callouts, las diferencias o márgenes internos del rectángulo, los border effects, la entrada de rotación, el intent distinto de FreeText, las anotaciones no opacas, los bordes redondeados y los estilos de borde que no sean sólido o discontinuo se rechazan con EArgumentException

Los componentes de fondo DeviceGray, DeviceRGB y DeviceCMYK deben estar entre cero y uno; los anchos de borde y los dash patterns deben ser válidos, finitos y no negativos, y un dash pattern no vacío de puros ceros se rechaza

La entrada no admitida se valida antes de reemplazar la anotación o su apariencia

Ejemplo

Para un documento cargado cuya primera anotación en la página cero es una anotación FreeText compatible

PDF.SetLoadedFreeTextPlainText(0, 0,
  'Updated review note'#13#10'Second line', 12);

APIs relacionadas

SetLoadedAnnotationContents solo cambia la cadena de contents almacenada y conserva la apariencia existente

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · Inicio