En esta página

QFontMetricsF Class

La clase QFontMetricsF proporciona información sobre las métricas de las fuentes. Más información...

Encabezado: #include <QFontMetricsF>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

QFontMetricsF(const QFont &font)
QFontMetricsF(const QFontMetrics &fontMetrics)
QFontMetricsF(const QFont &font, const QPaintDevice *paintdevice)
QFontMetricsF(const QFontMetricsF &fm)
QFontMetricsF(QFontMetricsF &&)
~QFontMetricsF()
qreal ascent() const
qreal averageCharWidth() const
QRectF boundingRect(QChar ch) const
QRectF boundingRect(const QString &text) const
(since 6.3) QRectF boundingRect(const QString &text, const QTextOption &option) const
QRectF boundingRect(const QRectF &rect, int flags, const QString &text, int tabStops = 0, int *tabArray = nullptr) const
qreal capHeight() const
qreal descent() const
QString elidedText(const QString &text, Qt::TextElideMode mode, qreal width, int flags = 0) const
qreal fontDpi() const
qreal height() const
(since 6.3) qreal horizontalAdvance(const QString &text, const QTextOption &option) const
qreal horizontalAdvance(const QString &text, int length = -1) const
qreal horizontalAdvance(QChar ch) const
bool inFont(QChar ch) const
bool inFontUcs4(uint ch) const
qreal leading() const
qreal leftBearing(QChar ch) const
qreal lineSpacing() const
qreal lineWidth() const
qreal maxWidth() const
qreal minLeftBearing() const
qreal minRightBearing() const
qreal overlinePos() const
qreal rightBearing(QChar ch) const
QSizeF size(int flags, const QString &text, int tabStops = 0, int *tabArray = nullptr) const
qreal strikeOutPos() const
void swap(QFontMetricsF &other)
QRectF tightBoundingRect(const QString &text) const
(since 6.3) QRectF tightBoundingRect(const QString &text, const QTextOption &option) const
qreal underlinePos() const
qreal xHeight() const
bool operator!=(const QFontMetricsF &other) const
QFontMetricsF &operator=(QFontMetricsF &&other)
QFontMetricsF &operator=(const QFontMetrics &other)
QFontMetricsF &operator=(const QFontMetricsF &fm)
bool operator==(const QFontMetricsF &other) const

Descripción detallada

Las funciones de QFontMetricsF calculan el tamaño de los caracteres y las cadenas para una fuente determinada. Se puede crear un objeto QFontMetricsF a partir de un objeto ` QFont ` existente para obtener las métricas de esa fuente. Si la fuente se cambia posteriormente, el objeto de métricas de la fuente no se actualiza.

Una vez creado, el objeto proporciona funciones para acceder a las métricas individuales de la fuente, a sus caracteres y a las cadenas representadas con dicha fuente.

Existen varias funciones que operan sobre la fuente: ascent(), descent(), height(), leading() y lineSpacing() devuelven las propiedades básicas de tamaño de la fuente. Las funciones underlinePos(), overlinePos(), strikeOutPos() y lineWidth() devuelven las propiedades de la línea que subraya, sobrelinea o tacha los caracteres. Todas estas funciones son rápidas.

También hay algunas funciones que operan sobre el conjunto de glifos de la fuente: minLeftBearing(), minRightBearing() y maxWidth(). Estas son, por necesidad, lentas, y recomendamos evitarlas en la medida de lo posible.

Para cada carácter, puedes obtener su horizontalAdvance(), leftBearing() y rightBearing(), y averiguar si está presente en la fuente mediante inFont(). También puedes tratar el carácter como una cadena y aplicar las funciones de cadena sobre él.

Las funciones de cadena incluyen horizontalAdvance(), que devuelve la anchura de una cadena en píxeles (o puntos, para una impresora); boundingRect(), que devuelve un rectángulo lo suficientemente grande como para contener la cadena representada; y size(), que devuelve el tamaño de dicho rectángulo.

QFontMetrics dispone de dos funciones diferentes para calcular los límites de una cadena, cada una con múltiples sobrecargas: ` boundingRect()` y ` tightBoundingRect()`. Si se necesita un rectángulo delimitador preciso, se debe dar preferencia a ` tightBoundingRect()`. Esta función medirá cada glifo individualmente para devolver un rectángulo delimitador que se ajuste perfectamente al texto renderizado. Dependiendo de la plataforma, la función boundingRect() puede devolver límites aproximados, pero requiere menos cálculo.

Ejemplo:

QFont font("times", 24);
QFontMetricsF fm(font);
qreal pixelsWide = fm.horizontalAdvance("What's the advance width of this text?");
qreal pixelsHigh = fm.height();

Véase también QFont, QFontInfo y QFontDatabase.

Documentación de funciones de miembro

[explicit] QFontMetricsF::QFontMetricsF(const QFont &font)

Crea un objeto de métricas de fuente para font.

Las métricas de la fuente serán compatibles con el dispositivo de dibujo utilizado para crear font.

El objeto de métricas de fuente contiene la información de la fuente que se pasa al constructor en el momento de su creación, y no se actualiza si los atributos de la fuente se modifican posteriormente.

Utiliza QFontMetricsF(const QFont &, QPaintDevice *) para obtener las métricas de fuente compatibles con un dispositivo de dibujo concreto.

QFontMetricsF::QFontMetricsF(const QFontMetrics &fontMetrics)

Crea un objeto de métricas de fuente con precisión de punto flotante a partir del objeto ` fontMetrics ` proporcionado.

QFontMetricsF::QFontMetricsF(const QFont &font, const QPaintDevice *paintdevice)

Crea un objeto de métricas de fuente para font y paintdevice.

Las métricas de la fuente serán compatibles con el dispositivo de dibujo (paintdevice) pasado. Si paintdevice es nullptr, las métricas serán compatibles con la pantalla, es decir, las métricas que se obtienen al utilizar la fuente para dibujar texto en un widgets o pixmaps, no en un QPicture o QPrinter.

El objeto de métricas de la fuente contiene la información de la fuente que se pasa al constructor en el momento de su creación, y no se actualiza si los atributos de la fuente se modifican posteriormente.

QFontMetricsF::QFontMetricsF(const QFontMetricsF &fm)

Crea una copia de fm.

[constexpr noexcept default] QFontMetricsF::QFontMetricsF(QFontMetricsF &&)

Crea una instancia de ` QFontMetricsF` mediante la construcción «move».

[noexcept] QFontMetricsF::~QFontMetricsF()

Destruye el objeto de métricas de fuente y libera todos los recursos asignados.

qreal QFontMetricsF::ascent() const

Devuelve la altura de ascendente de la fuente.

La altura de ascenso de una fuente es la distancia desde la línea de base hasta la posición más alta a la que llegan los caracteres. En la práctica, algunos diseñadores de fuentes se saltan esta regla, por ejemplo, cuando colocan más de un acento encima de un carácter o para dar cabida a un carácter concreto, por lo que es posible (aunque poco frecuente) que este valor sea demasiado pequeño.

Véase también descent().

qreal QFontMetricsF::averageCharWidth() const

Devuelve el ancho medio de los glifos de la fuente.

QRectF QFontMetricsF::boundingRect(QChar ch) const

Devuelve el rectángulo delimitador del carácter ch en relación con el punto más a la izquierda de la línea de base.

Ten en cuenta que el rectángulo delimitador puede extenderse a la izquierda de (0, 0), por ejemplo, en el caso de las fuentes en cursiva, y que la salida de texto puede abarcar todos los píxeles del rectángulo delimitador.

Ten en cuenta que el rectángulo suele extenderse tanto por encima como por debajo de la línea de base.

Véase también horizontalAdvance().

QRectF QFontMetricsF::boundingRect(const QString &text) const

Devuelve el rectángulo delimitador de los caracteres de la cadena especificada por ` text`. El rectángulo delimitador siempre abarca, como mínimo, el conjunto de píxeles que cubriría el texto si se dibujara en (0, 0).

Ten en cuenta que el rectángulo delimitador puede extenderse a la izquierda de (0, 0), por ejemplo, en el caso de las fuentes en cursiva, y que la anchura del rectángulo devuelto podría ser diferente de la que devuelve el método horizontalAdvance().

Si quieres conocer el ancho de avance de la cadena (para maquetar un conjunto de cadenas una al lado de otra), utiliza en su lugar horizontalAdvance().

Los caracteres de nueva línea se procesan como caracteres normales, no como saltos de línea.

La altura del rectángulo delimitador es, como mínimo, igual al valor devuelto por height().

Véanse también horizontalAdvance(), height() y QPainter::boundingRect().

[since 6.3] QRectF QFontMetricsF::boundingRect(const QString &text, const QTextOption &option) const

Devuelve el rectángulo delimitador de los caracteres de la cadena especificada por ` text `, maquetada mediante ` option`. El rectángulo delimitador siempre abarca, como mínimo, el conjunto de píxeles que cubriría el texto si se dibujara en (0, 0).

Ten en cuenta que el rectángulo delimitador puede extenderse a la izquierda de (0, 0), por ejemplo, en el caso de las fuentes en cursiva, y que la anchura del rectángulo devuelto podría ser diferente de la que devuelve el método horizontalAdvance().

Si quieres conocer el ancho de avance de la cadena (para maquetar un conjunto de cadenas una al lado de otra), utiliza en su lugar horizontalAdvance().

Los caracteres de nueva línea se procesan como caracteres normales, no como saltos de línea.

La altura del rectángulo delimitador es, como mínimo, igual al valor devuelto por height().

Esta función se introdujo en Qt 6.3.

Véase también horizontalAdvance(), height() y QPainter::boundingRect().

QRectF QFontMetricsF::boundingRect(const QRectF &rect, int flags, const QString &text, int tabStops = 0, int *tabArray = nullptr) const

Devuelve el rectángulo delimitador de los caracteres del objeto ` text` dado. Se trata del conjunto de píxeles que cubriría el texto si se dibujara limitado al rectángulo delimitador especificado por ` rect`. Si ` rect ` es una referencia a un objeto ` nullptr `, por ejemplo, al pasar un objeto ` QRectF` construido por defecto, el rectángulo delimitador no se limitará al tamaño indicado.

El argumento ` flags ` es la operación OR bit a bit de los siguientes indicadores:

Qt::Horizontal La alineación predeterminada es Qt::AlignLeft y la alineación vertical predeterminada es Qt::AlignTop.

Si se activan varias de las opciones de alineación horizontal o varias de las de alineación vertical, la alineación resultante no está definida.

Estos indicadores se definen en Qt::AlignmentFlag.

Si « Qt::TextExpandTabs » se establece en « flags », se utiliza el siguiente comportamiento para interpretar los caracteres de tabulación en el texto:

  • Si ` tabArray ` no es nulo, especifica una secuencia terminada en 0 de posiciones en píxeles para las tabulaciones del texto.
  • Si tabStops es distinto de cero, se utiliza como espaciado de las tabulaciones (en píxeles).

Ten en cuenta que el rectángulo delimitador puede extenderse a la izquierda de (0, 0), por ejemplo, en el caso de las fuentes en cursiva.

Los caracteres de nueva línea se procesan como saltos de línea.

A pesar de las diferentes alturas reales de los caracteres, las alturas de los rectángulos delimitadores de «Yes» y «yes» son iguales.

El rectángulo delimitador devuelto por esta función es algo mayor que el calculado por la función más sencilla `boundingRect()`. Esta función utiliza los valores de ` maximum left ` y ` right ` de la fuente, tal y como es necesario para que el texto multilínea se alinee correctamente. Además, se utilizan `fontHeight()` y ` lineSpacing()` para calcular la altura, en lugar de las alturas de los caracteres individuales.

Se trata de una función sobrecargada.

Véanse también horizontalAdvance(), QPainter::boundingRect() y Qt::Alignment.

qreal QFontMetricsF::capHeight() const

Devuelve la altura de mayúscula de la fuente.

La altura de mayúscula de una fuente es la altura que tiene una letra mayúscula por encima de la línea de base. Concretamente, se trata de la altura de las letras mayúsculas planas —como la H o la I—, en contraposición a las letras redondeadas, como la O, o las letras puntiagudas, como la A, las cuales pueden presentar un saliente.

Véase también ascent().

qreal QFontMetricsF::descent() const

Devuelve el descenso de la fuente.

El descenso es la distancia desde la línea de base hasta el punto más bajo al que llegan los caracteres. (Ten en cuenta que esto difiere de X, que añade 1 píxel). En la práctica, algunos diseñadores de fuentes se saltan esta regla, por ejemplo, para adaptarse a un carácter concreto, por lo que es posible (aunque poco frecuente) que este valor sea demasiado pequeño.

Véase también ascent().

QString QFontMetricsF::elidedText(const QString &text, Qt::TextElideMode mode, qreal width, int flags = 0) const

Si la cadena « text » ocupa más espacio que « width », devuelve una versión truncada de la cadena (es decir, una cadena que contiene «...»). En caso contrario, devuelve la cadena original.

El parámetro mode especifica si el texto se trunca por la izquierda (por ejemplo, «...tech»), por el centro (por ejemplo, «Tr...ch») o por la derecha (por ejemplo, «Trol...»).

width se especifica en píxeles, no en caracteres.

El argumento ` flags ` es opcional y, actualmente, solo admite ` Qt::TextShowMnemonic ` como valor.

La marca de elisión sigue a la « layoutdirection ». Por ejemplo, aparecerá a la derecha del texto en diseños de derecha a izquierda si la « mode » es « Qt::ElideLeft », y a la izquierda del texto si la « mode » es « Qt::ElideRight ».

qreal QFontMetricsF::fontDpi() const

Devuelve los DPI de la fuente.

qreal QFontMetricsF::height() const

Devuelve la altura de la fuente.

Este valor es siempre igual a ` ascent()` + `descent()`.

Véase también leading() y lineSpacing().

[since 6.3] qreal QFontMetricsF::horizontalAdvance(const QString &text, const QTextOption &option) const

Devuelve el avance horizontal, en píxeles, de « text » maquetado mediante « option ».

El avance es la distancia adecuada para dibujar un carácter posterior a « text ».

Esta función se introdujo en Qt 6.3.

Véase también ` boundingRect()`.

qreal QFontMetricsF::horizontalAdvance(const QString &text, int length = -1) const

Devuelve el avance horizontal en píxeles de los primeros length caracteres de text. Si length es negativo (valor por defecto), se utiliza la cadena completa. Se analiza toda la longitud de text, incluso si length es considerablemente más corta.

El avance es la distancia adecuada para dibujar un carácter posterior a text.

Véase también boundingRect().

qreal QFontMetricsF::horizontalAdvance(QChar ch) const

Rodamientos

Devuelve el avance horizontal del carácter ch en píxeles. Se trata de la distancia adecuada para dibujar un carácter posterior tras ch.

Algunas de las métricas se describen en la imagen de la derecha. Los rectángulos oscuros centrales abarcan el avance horizontal lógico (horizontalAdvance()) de cada carácter. Los rectángulos claros exteriores abarcan el avance de caracteres ( leftBearing()) y el avance de caracteres de la derecha ( rightBearing()) de cada carácter. Obsérvese que los «bearings» de la «f» en esta fuente concreta son ambos negativos, mientras que los de la «o» son ambos positivos.

Advertencia: Esta función producirá resultados incorrectos para los caracteres árabes o los signos no espaciadores situados en medio de una cadena, ya que no se puede tener en cuenta la configuración de los glifos y el posicionamiento de los signos que se produce al procesar las cadenas. Al implementar un control de texto interactivo, utiliza QTextLayout en su lugar.

Esta es una función sobrecargada.

Véase también boundingRect().

bool QFontMetricsF::inFont(QChar ch) const

Devuelve « true » si el carácter « ch » es un carácter válido en la fuente; en caso contrario, devuelve « false ».

bool QFontMetricsF::inFontUcs4(uint ch) const

Devuelve « true » si el carácter indicado por « ch », codificado en UCS-4/UTF-32, es un carácter válido en la fuente; en caso contrario, devuelve « false ».

qreal QFontMetricsF::leading() const

Devuelve el interlineado superior de la fuente.

Se trata del interlineado natural.

Véase también height() y lineSpacing().

qreal QFontMetricsF::leftBearing(QChar ch) const

Devuelve la coordenada de izquierda del carácter ch en la fuente.

El desplazamiento hacia la izquierda es la distancia hacia la derecha que hay entre el píxel más a la izquierda del carácter y el origen lógico del mismo. Este valor es negativo si los píxeles del carácter se extienden hacia la izquierda del origen lógico.

Consulta horizontalAdvance() para obtener una descripción gráfica de esta métrica.

Véanse también rightBearing(), minLeftBearing() y horizontalAdvance().

qreal QFontMetricsF::lineSpacing() const

Devuelve la distancia entre una línea base y la siguiente.

Este valor es siempre igual a leading() +height().

Véanse también height() y leading().

qreal QFontMetricsF::lineWidth() const

Devuelve el ancho de las líneas de subrayado y tachado, ajustado al tamaño en puntos de la fuente.

Véase también underlinePos(), overlinePos() y strikeOutPos().

qreal QFontMetricsF::maxWidth() const

Devuelve la anchura del carácter más ancho de la fuente.

qreal QFontMetricsF::minLeftBearing() const

Devuelve el ángulo mínimo hacia la izquierda de la fuente.

Se trata del valor « leftBearing » (char) más pequeño de todos los caracteres de la fuente.

Ten en cuenta que esta función puede ser muy lenta si la fuente es grande.

Véanse también minRightBearing() y leftBearing().

qreal QFontMetricsF::minRightBearing() const

Devuelve el ángulo de inclinación hacia la derecha mínimo de la fuente.

Se trata del « rightBearing » (char) más pequeño de todos los caracteres de la fuente.

Ten en cuenta que esta función puede ser muy lenta si la fuente es grande.

Véanse también « minLeftBearing()» y « rightBearing()».

qreal QFontMetricsF::overlinePos() const

Devuelve la distancia desde la línea de base hasta el punto en el que debe trazarse una línea superior.

Véase también underlinePos(), strikeOutPos() y lineWidth().

qreal QFontMetricsF::rightBearing(QChar ch) const

Devuelve la posición a la derecha del carácter ch en la fuente.

El desplazamiento hacia la derecha es la distancia hacia la izquierda del píxel más a la derecha del carácter con respecto al origen lógico del carácter siguiente. Este valor es negativo si los píxeles del carácter se extienden hacia la derecha del horizontalAdvance() del carácter.

Consulte « horizontalAdvance()» para obtener una descripción gráfica de esta métrica.

Véanse también leftBearing(), minRightBearing() y horizontalAdvance().

QSizeF QFontMetricsF::size(int flags, const QString &text, int tabStops = 0, int *tabArray = nullptr) const

Devuelve el tamaño en píxeles de los caracteres del ` text` indicado.

El argumento ` flags ` es el OR bit a bit de los siguientes indicadores:

Estos indicadores se definen en la enumeración Qt::TextFlag.

Si se establece ` Qt::TextExpandTabs ` en ` flags`, se utiliza el siguiente comportamiento para interpretar los caracteres de tabulación en el texto:

  • Si tabArray no es nulo, especifica una secuencia terminada en 0 de posiciones de píxeles para las tabulaciones del texto.
  • Si ` tabStops ` es distinto de cero, se utiliza como espaciado de tabulación (en píxeles).

Los caracteres de nueva línea se procesan como saltos de línea.

Nota: A pesar de las diferentes alturas reales de los caracteres, las alturas de los rectángulos delimitadores de «Yes» y «yes» son iguales.

Véase también boundingRect().

qreal QFontMetricsF::strikeOutPos() const

Devuelve la distancia desde la línea de base hasta el punto en el que se debe trazar la línea de strike.

Véase también underlinePos(), overlinePos() y lineWidth().

[noexcept] void QFontMetricsF::swap(QFontMetricsF &other)

Sustituye esta instancia de métricas de fuente por other. Esta operación es muy rápida y nunca falla.

QRectF QFontMetricsF::tightBoundingRect(const QString &text) const

Devuelve un rectángulo delimitador ajustado alrededor de los caracteres de la cadena especificada por ` text`. El rectángulo delimitador siempre abarca, como mínimo, el conjunto de píxeles que cubriría el texto si se dibujara en (0, 0).

Ten en cuenta que el rectángulo delimitador puede extenderse a la izquierda de (0, 0), por ejemplo, en el caso de las fuentes en cursiva, y que la anchura del rectángulo devuelto puede diferir de la que devuelve el método horizontalAdvance().

Si quieres conocer el ancho de avance de la cadena (para maquetar un conjunto de cadenas una junto a otra), utiliza horizontalAdvance() en su lugar.

Los caracteres de nueva línea se procesan como caracteres normales, no como saltos de línea.

Véase también horizontalAdvance(), height() y boundingRect().

[since 6.3] QRectF QFontMetricsF::tightBoundingRect(const QString &text, const QTextOption &option) const

Devuelve un rectángulo delimitador ajustado alrededor de los caracteres de la cadena especificada por ` text `, maquetada mediante ` option`. El rectángulo delimitador siempre abarca, como mínimo, el conjunto de píxeles que cubriría el texto si se dibujara en (0,0).

Ten en cuenta que el rectángulo delimitador puede extenderse a la izquierda de (0, 0), por ejemplo, en el caso de las fuentes en cursiva, y que la anchura del rectángulo devuelto puede ser diferente de la que devuelve el método horizontalAdvance().

Si quieres conocer el ancho de avance de la cadena (para maquetar un conjunto de cadenas una al lado de otra), utiliza en su lugar horizontalAdvance().

Los caracteres de nueva línea se procesan como caracteres normales, no como saltos de línea.

Esta función se introdujo en Qt 6.3.

Véase también horizontalAdvance(), height() y boundingRect().

qreal QFontMetricsF::underlinePos() const

Devuelve la distancia desde la línea de base hasta el punto en el que debe trazarse un guión bajo.

Véase también overlinePos(), strikeOutPos() y lineWidth().

qreal QFontMetricsF::xHeight() const

Devuelve la altura «x» de la fuente. A menudo, aunque no siempre, coincide con la altura del carácter «x».

bool QFontMetricsF::operator!=(const QFontMetricsF &other) const

Devuelve ` true ` si las métricas de la fuente no son iguales a las métricas de la fuente ` other `; en caso contrario, devuelve ` false`.

Véase también operator==().

[noexcept] QFontMetricsF &QFontMetricsF::operator=(QFontMetricsF &&other)

Asigna « other » a esta instancia de « QFontMetricsF ». .

QFontMetricsF &QFontMetricsF::operator=(const QFontMetrics &other)

Asigna ` other ` a este objeto.

QFontMetricsF &QFontMetricsF::operator=(const QFontMetricsF &fm)

Asigna las métricas de fuente fm a este objeto de métricas de fuente.

bool QFontMetricsF::operator==(const QFontMetricsF &other) const

Devuelve ` true ` si las métricas de la fuente son iguales a las de ` other `; en caso contrario, devuelve ` false`.

Se considera que dos métricas de fuente son iguales si se han construido a partir del mismo QFont y si los dispositivos de dibujo para los que se han construido se consideran compatibles.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.