DrawShapedText

Texto

Descripción

Esta página describe DrawShapedText en PDFlibPas dentro del tema «Texto». Los nombres de API, parámetros, clases, archivos y valores literales se conservan tal como aparecen en la biblioteca Delphi y los puntos de entrada DLL.

Revise la sintaxis, los parámetros y los valores de retorno antes de llamar a la función.

Sintaxis

Delphi

Function TPDFlib.DrawShapedText(XPos, YPos: Double; Const FontName: WideString; Size: Double; Const Text: WideString; Options: Integer): Integer;

Parámetros

XPos/YPos posicionan el texto en unidades de página. FontName indica el nombre de una tipografía instalada (por ejemplo, Arial). Size es el tamaño del texto en puntos. Text es la cadena que se formará y dibujará. El bit 0 de Options selecciona una dirección de párrafo base de derecha a izquierda; actívelo para texto en árabe o hebreo.

Valor de retorno

Devuelve 1 en caso de éxito; 0 cuando el motor de formación tipográfica no está disponible, la tipografía no está instalada o Text está vacío.

Observaciones

El texto se forma con el motor de formación tipográfica del sistema antes del dibujo, de modo que las letras árabes adoptan sus formas correctas de inicio de palabra, medial, final o aislada; se aplican ligaduras obligatorias como lam-alef; y las secuencias de derecha a izquierda aparecen en el orden visual correcto. Los glifos formados se escriben por índice de glifo mediante una fuente Type0 complementaria (Identity-H), lo que permite que los glifos sin código de carácter propio se rendericen correctamente. Se crea una fuente complementaria por tipografía y se reutiliza en llamadas posteriores del mismo documento. Al guardar el documento, el programa de fuente embebido se subsettea con solo los glifos que el documento muestra, con avances reales por glifo y un mapa ToUnicode que traduce cada glifo formado de vuelta a sus caracteres de origen — de modo que el texto copiado o extraído del resultado devuelve la cadena original, incluidas las ligaduras. El posicionamiento es exacto: cada avance de glifo del motor de formación se escribe en el flujo de contenido, por lo que el diseño impreso coincide con la medición formada de GetShapedTextWidth.