Método THotPDF.SetLoadedFreeTextText

Reemplaza la apariencia normal de una anotación FreeText cargada usando tipografías Unicode embebidas, texto enriquecido opcional y una transacción atómica del grafo

Declaración

procedure SetLoadedFreeTextText(PageIndex, AnnotationIndex: Integer;
  const AText: UnicodeString; const Options: THPDFLoadedTextAppearanceOptions;
  const RichContent: AnsiString = ''; const DefaultStyle: AnsiString = '');

Opciones

Inicialicen el record con THPDFLoadedTextAppearanceOptions.Default antes de cambiar campos individuales

CampoComportamiento
FontName, FontStyle, FontSizeTipografía primaria, estilo y tamaño en puntos; los valores predeterminados son Arial, regular y 12 puntos
TextColor, Alignment, PaddingColor del texto plano, alineación izquierda/centro/derecha y padding en puntos; los valores predeterminados son negro, izquierda y 2 puntos
Opacity, RotationOpacidad en [0,1] y rotación en múltiplos de 90 grados
OverflowPolicyTHPDFLoadedTextOverflowPolicy: ltopReject rechaza el desbordamiento, ltopClip lo recorta y ltopShrinkToFit reintenta con tipografías más pequeñas
MinFontSizeLímite inferior para la reducción, con 4 puntos predeterminados
MaxTextUnitsPresupuesto de entrada y de texto plano, con 1,048,576 unidades UTF-16 predeterminadas; la entrada enriquecida se limita a cuatro veces este presupuesto

Comportamiento

AText suministra texto Unicode plano; un RichContent UTF-8 no vacío usa en su lugar el importador HTML y el DefaultStyle CSS opcional, y luego deriva /Contents del texto generado

La apariencia generada copia las tipografías embebidas y los mapeos ToUnicode al documento cargado, así que el guardado, el aplanado y la extracción de texto conservan su texto Unicode

El método hereda las cadenas de fallback de tipografías configuradas, ShapingFeatures, los interruptores de auto-shaping de árabe, siríaco, N'Ko, Adlam y Hanifi Rohingya, y las selecciones de script y de idioma GSUB; cada reintento de shrink-to-fit usa la misma configuración sin cambiar la configuración de quien llama

Preserva el fondo soportado, el borde sólido/discontinuo, los insets de rectángulo y la geometría de callout de dos/tres puntos, y sincroniza los metadatos de /AP, /Contents, /RC, /DS, /CA, /Q y la rotación

La geometría inválida, los glifos de texto plano sin resolver, los bordes cloudy, los límites de recursos y el desbordamiento rechazado lanzan una excepción y hacen rollback de toda la actualización; las transacciones externas del grafo ya existentes permanecen activas

El texto enriquecido sigue el subconjunto HTML/CSS soportado; los recursos externos están deshabilitados y los tamaños fijos de tipografía CSS pueden impedir que el shrink-to-fit reduzca las ejecuciones individuales

Cada escritor de apariencias acepta a lo sumo 256 selecciones de tipografía de shaping distintas y 64 MiB de datos crudos de tipografías acumulados; exceder cualquiera de los dos límites rechaza la actualización y preserva la anotación original

APIs relacionadas