FontAscent Propiedad

Esta entrada API conserva identificadores, firmas, bloques de código y términos PDF en su forma original.

Devuelve la ascensión de la fuente (distancia desde la línea base hasta el ascendente más alto) de la fuente de un objeto de página, expresada en puntos PDF y escalada a un tamaño de fuente proporcionado por el llamador

FontAscent informa de la métrica de ascensión de la fuente referenciada por el objeto de página en el índice dado. La ascensión es la distancia vertical desde la línea base hasta el punto más alto alcanzado por los caracteres más altos de la fuente (mayúsculas, acentos, ascendentes como 'l', 'h' o 'k'). El resultado se expresa en puntos del espacio de usuario PDF, ya escalado al FontSize que pases

El indexador Index es el índice de objeto de página basado en cero (0..ObjectCount - 1). El segundo indexador, FontSize, es el tamaño en puntos PDF al que se debe calcular la métrica. Pasa el tamaño al que piensas renderizar, o usa CharacterFontSize[n] para reflejar el tamaño de un fragmento de texto existente. La página debe estar activa al leer la propiedad

Junto con FontDescent esto da la altura total de línea de la fuente: LineHeight := FontAscent - FontDescent (la descent suele ser negativa). PDFium devuelve 0 cuando la fuente carece de la métrica o cuando el objeto indexado no es texto

• Devuelve un valor positivo — la ascensión se mide hacia arriba desde la línea base
• Para una maquetación fiel tipográficamente, combina ascensión y descent en lugar de usar solo FontSize
• Devuelve 0 cuando la fuente no tiene entrada de ascensión o cuando el objeto no es texto — protégelo siempre frente a ese caso
• Las fuentes CJK suelen informar de ascensiones más altas que las fuentes occidentales al mismo tamaño; no asumas que las métricas latinas se transfieren
• El primer indexador de la propiedad coincide con el índice de objeto de página usado por FontHandle, no con el índice de carácter usado por Character

FontDescent, FontSize, FontHandle, FontFamilyName