QFontInfo Class
La clase QFontInfo proporciona información general sobre las fuentes. Más...
| Encabezado: | #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 miembros heredados
- Miembros obsoletos
- QFontInfo forma parte de las clases compartidas implícitamente.
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| QFontInfo(const QFont &font) | |
| QFontInfo(const QFontInfo &fi) | |
| QFontInfo(QFontInfo &&) | |
| ~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. Sin embargo, mientras que las funciones de acceso de QFont devuelven los valores que se han establecido, un objeto QFontInfo devuelve los valores que se aplican a la fuente que se utilizará realmente para dibujar el texto.
Por ejemplo, cuando el programa solicita una fuente Courier de 25 pt en un equipo que dispone de una fuente Courier de 24 pt no escalable, QFont utilizará (normalmente) la fuente Courier de 24 pt para la representación. En este caso, QFont::pointSize() devuelve 25 y QFontInfo::pointSize() devuelve 24.
Hay tres formas de crear un objeto QFontInfo.
- Al llamar al constructor de QFontInfo con un objeto ` QFont `, se crea un objeto de información de fuente 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 de información de fuente no se actualiza.
(Nota: Si se utiliza una fuente de impresora, los valores devueltos pueden ser inexactos. No siempre se puede acceder a las fuentes de impresora, por lo que, si se proporciona una fuente de impresora, se utiliza la fuente de pantalla más similar.)
- QWidget::fontInfo() devuelve la información de la fuente de un widget. Esto equivale a llamar a QFontInfo(widget->font()). Si la fuente del widget se cambia posteriormente, el objeto de información de fuente 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 la fuente no se actualiza.
Comprobación de la existencia de una fuente
A veces puede resultar ú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 exhaustiva de familias puede resultar costosa en algunas plataformas. QFontDatabase::families().contains() es una alternativa más rápida, aunque menos exhaustiva:
const QLatin1String segoeUiFamilyName("Segoe UI");
if (QFontDatabase::families().contains(segoeUiFamilyName)) {
const QFont segoeFont(segoeUiFamilyName);
// Use the font...
}Es menos exhaustiva porque no se trata de una búsqueda completa: es posible que falten en la lista algunos alias de familias de fuentes. No obstante, este enfoque permite que la aplicación se inicie más rápido, por lo que siempre debe preferirse si es posible.
Véase también QFont, QFontMetrics y QFontDatabase.
Documentación de las funciones miembro
QFontInfo::QFontInfo(const QFont &font)
Crea un objeto de información de fuente 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 en QPicture ni en QPrinter.
El objeto de información 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.
Utiliza ` QPainter::fontInfo()` para obtener la información de la fuente al dibujar. Esto proporcionará resultados correctos incluso al dibujar en un dispositivo de dibujo que no sea compatible con la pantalla.
Véase también Checking for the existence of a font.
QFontInfo::QFontInfo(const QFontInfo &fi)
Crea una copia de fi.
[constexpr noexcept default] QFontInfo::QFontInfo(QFontInfo &&)
Crea una instancia de « QFontInfo » mediante la construcción «move».
[noexcept] QFontInfo::~QFontInfo()
Elimina el objeto de información de la fuente.
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 encontrada coincide exactamente con 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 la ventana con la que coincide.
Véase también QFont::family() y Checking for the existence of a font.
bool QFontInfo::fixedPitch() const
Devuelve el valor de espaciado fijo de la fuente del sistema de ventana adaptada.
Véase también QFont::fixedPitch().
bool QFontInfo::italic() const
Devuelve el valor en cursiva de la fuente del sistema de ventanas que coincida.
Véase también QFont::italic().
int QFontInfo::pixelSize() const
Devuelve el tamaño en píxeles de la fuente del sistema de ventanas que coincide.
Véase también QFont::pointSize().
int QFontInfo::pointSize() const
Devuelve el tamaño en puntos de la fuente del sistema de ventanas que coincide.
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 que coincide.
Véase también QFont::pointSizeF().
QFont::Style QFontInfo::style() const
Devuelve el valor de estilo de la fuente del sistema de la ventana con la que coincide.
Véase también QFont::style().
QFont::StyleHint QFontInfo::styleHint() const
Devuelve el estilo de la fuente del sistema de ventanas que coincide.
Actualmente solo devuelve la indicación de estilo establecida en QFont.
Véase también QFont::styleHint() y QFont::StyleHint.
QString QFontInfo::styleName() const
Devuelve el nombre del estilo de la fuente del sistema de ventanas que coincide, en los sistemas que lo admiten.
Véase también ` QFont::styleName()`.
[noexcept] void QFontInfo::swap(QFontInfo &other)
Sustituye esta instancia de información de fuente por 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 admite la fuente.
Consulta setVariableAxis() para obtener más detalles sobre los ejes variables.
Esta función se introdujo en Qt 6.9.
int QFontInfo::weight() const
Devuelve el grosor de la fuente del sistema de la ventana que coincide.
Véase también QFont::weight() y bold().
QFontInfo &QFontInfo::operator=(const QFontInfo &fi)
Asigna la información sobre la fuente que figura 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.