THotPDF.SetLoadedFreeTextPlainText Method

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 de la página cargada basado en cero
• AnnotationIndex: índice de la anotación en esa página basado en cero
• AText: caracteres ASCII imprimibles, con CR, LF o CR/LF para saltos de línea explícitos; se rechazan los tabuladores, los demás caracteres de control y el texto no ASCII
• FontSize: tamaño finito en puntos PDF, mayor que cero y de como mucho 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 color de dispositivo compatible y la geometría de borde sólida o discontinua, 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 a 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 intencionada

Los cambios de anotación, apariencia y página se registran para el guardado incremental y la caché de renderizado 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 efectos de borde, la entrada de rotación, el intent distinto de FreeText, las anotaciones no opacas, los bordes redondeados y los estilos de borde distintos de 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 patrones de guiones deben ser válidos, finitos y no negativos, y un patrón de guiones no vacío formado solo por 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 contenidos almacenada y conserva la apariencia existente

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · Inicio