QFontInfo Class
La clase QFontInfo proporciona información general sobre las fuentes. Más...
| Cabecera: | #include <QFontInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QFontInfo es parte de Clases Implícitamente Compartidas.
Nota: Todas las funciones de esta clase son reentrantes.
Funciones Públicas
| QFontInfo(const QFont &font) | |
| QFontInfo(const QFontInfo &fi) | |
| ~QFontInfo() | |
| bool | bold() const |
| bool | exactMatch() const |
| QString | family() const |
| bool | fixedPitch() const |
| bool | italic() const |
| int | pixelSize() const |
| int | pointSize() const |
| qreal | pointSizeF() const |
| QFont::Style | style() const |
| QFont::StyleHint | styleHint() const |
| QString | styleName() const |
| void | swap(QFontInfo &other) |
(since 6.9) QList<QFontVariableAxis> | variableAxes() const |
| int | weight() const |
| QFontInfo & | operator=(const QFontInfo &fi) |
Descripción Detallada
La clase QFontInfo proporciona las mismas funciones de acceso que QFont, por ejemplo family(), pointSize(), italic(), weight(), fixedPitch(), styleHint() etc. Pero mientras que las funciones de acceso de QFont devuelven los valores que se establecieron, un objeto QFontInfo devuelve los valores que se aplican a la fuente que realmente se utilizará para dibujar el texto.
Por ejemplo, cuando el programa pide una fuente Courier de 25pt en una máquina que tiene una fuente Courier no escalable de 24pt, QFont usará (normalmente) la Courier de 24pt para el renderizado. En este caso, QFont::pointSize() devuelve 25 y QFontInfo::pointSize() devuelve 24.
Hay tres formas de crear un objeto QFontInfo.
- Llamando al constructor QFontInfo con un QFont se crea un objeto font info para una fuente compatible con pantalla, es decir, la fuente no puede ser una fuente de impresora. Si la fuente se cambia posteriormente, el objeto font info no se actualiza.
(Nota: Si utiliza una fuente de impresora, los valores devueltos pueden ser inexactos. Las fuentes de impresora no siempre son accesibles, por lo que se utiliza la fuente de pantalla más cercana si se suministra una fuente de impresora).
- QWidget::fontInfo() devuelve la información de la fuente de un widget. Esto es equivalente a llamar a QFontInfo(widget->font()). Si la fuente del widget se cambia más tarde, el objeto font info no se actualiza.
- QPainter::fontInfo() devuelve la información de la fuente actual de un pintor. Si la fuente del pintor se cambia posteriormente, el objeto de información de fuentes no se actualiza.
Comprobación de la existencia de una fuente
A veces puede ser útil comprobar si una fuente existe antes de intentar utilizarla. La forma más exhaustiva de hacerlo es utilizando exactMatch():
const QFont segoeFont(QLatin1String("Segoe UI")); if (QFontInfo(segoeFont).exactMatch()) { // Use the font... }
Sin embargo, esta búsqueda profunda de familias puede ser costosa en algunas plataformas. QFontDatabase::families().contains() es una alternativa más rápida, pero menos exhaustiva:
const QLatin1String segoeUiFamilyName("Segoe UI"); if (QFontDatabase::families().contains(segoeUiFamilyName)) { const QFont segoeFont(segoeUiFamilyName); // Use the font... }
Es menos exhaustiva porque no es una búsqueda completa: algunos alias de familias tipográficas pueden faltar en la lista. Sin embargo, este método acelera el inicio de la aplicación, por lo que debería preferirse siempre que sea posible.
Véase también QFont, QFontMetrics, y QFontDatabase.
Documentación de las funciones miembro
QFontInfo::QFontInfo(const QFont &font)
Construye un objeto de información de fuentes para font.
La fuente debe ser compatible con la pantalla, es decir, una fuente que se utilice al dibujar texto en widgets o pixmaps, no QPicture o QPrinter.
El objeto font info contiene la información de la fuente que se pasa en el constructor en el momento de su creación, y no se actualiza si los atributos de la fuente se cambian posteriormente.
Utilice QPainter::fontInfo() para obtener la información de la fuente al pintar. Esto dará resultados correctos también cuando se pinte en un dispositivo de pintura que no sea compatible con pantallas.
Véase también Checking for the existence of a font.
QFontInfo::QFontInfo(const QFontInfo &fi)
Construye una copia de fi.
[noexcept] QFontInfo::~QFontInfo()
Destruye el objeto de información de fuentes.
bool QFontInfo::bold() const
Devuelve true si weight() devolvería un valor mayor que QFont::Normal; en caso contrario devuelve false.
Véase también weight() y QFont::bold().
bool QFontInfo::exactMatch() const
Devuelve true si la fuente del sistema de ventanas coincidente es exactamente la misma que la especificada por la fuente; en caso contrario devuelve false.
Véase también QFont::exactMatch().
QString QFontInfo::family() const
Devuelve el nombre de la familia de la fuente del sistema de ventanas coincidente.
Véase también QFont::family() y Checking for the existence of a font.
bool QFontInfo::fixedPitch() const
Devuelve el valor de paso fijo de la fuente del sistema de ventanas coincidente.
Véase también QFont::fixedPitch().
bool QFontInfo::italic() const
Devuelve el valor de cursiva de la fuente del sistema de ventanas coincidente.
Véase también QFont::italic().
int QFontInfo::pixelSize() const
Devuelve el tamaño en píxeles de la fuente del sistema de ventanas coincidente.
Véase también QFont::pointSize().
int QFontInfo::pointSize() const
Devuelve el tamaño en puntos de la fuente del sistema de ventanas coincidente.
Véase también pointSizeF() y QFont::pointSize().
qreal QFontInfo::pointSizeF() const
Devuelve el tamaño en puntos de la fuente del sistema de ventanas coincidente.
Véase también QFont::pointSizeF().
QFont::Style QFontInfo::style() const
Devuelve el valor de estilo de la fuente del sistema de ventanas coincidente.
Véase también QFont::style().
QFont::StyleHint QFontInfo::styleHint() const
Devuelve el estilo de la fuente coincidente del sistema de ventanas.
Actualmente sólo devuelve la sugerencia de estilo establecida en QFont.
Véase también QFont::styleHint() y QFont::StyleHint.
QString QFontInfo::styleName() const
Devuelve el nombre de estilo de la fuente del sistema de ventanas coincidente en los sistemas que lo soportan.
Véase también QFont::styleName().
[noexcept] void QFontInfo::swap(QFontInfo &other)
Intercambia esta instancia de información de fuentes con other. Esta operación es muy rápida y nunca falla.
[since 6.9] QList<QFontVariableAxis> QFontInfo::variableAxes() const
Si la fuente es una fuente variable, esta función devolverá la lista de ejes que soporta la fuente.
Véase setVariableAxis() para más detalles sobre ejes variables.
Esta función se introdujo en Qt 6.9.
int QFontInfo::weight() const
Devuelve el peso de la fuente del sistema de ventanas coincidente.
Véase también QFont::weight() y bold().
QFontInfo &QFontInfo::operator=(const QFontInfo &fi)
Asigna la información de la fuente en fi.
© 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.