QFontDatabase Class

QTreeWidget fontTree;
fontTree.setColumnCount(2);
fontTree.setHeaderLabels(QStringList() << "Font" << "Smooth Sizes");

const QStringList fontFamilies = QFontDatabase::families();
for (const QString &family : fontFamilies) {
    QTreeWidgetItem *familyItem = new QTreeWidgetItem(&fontTree);
    familyItem->setText(0, family);

    const QStringList fontStyles = QFontDatabase::styles(family);
    for (const QString &style : fontStyles) {
        QTreeWidgetItem *styleItem = new QTreeWidgetItem(familyItem);
        styleItem->setText(0, style);

        QString sizes;
        const QList<int> smoothSizes = QFontDatabase::smoothSizes(family, style);
        for (const auto &points : smoothSizes)
            sizes += QString::number(points) + ' ';

        styleItem->setText(1, sizes.trimmed());
    }
}

Documentación de las funciones miembro

[static, since 6.9] void QFontDatabase::addApplicationEmojiFontFamily(const QString &familyName)

Añade familyName como fuente emoji definida por la aplicación.

Para mostrar emojis multicolor o secuencias emoji, Qt preferirá por defecto la fuente emoji predeterminada del sistema. A veces la aplicación puede querer anular el valor por defecto, ya sea para lograr un estilo visual específico o para mostrar emojis que no son compatibles con el sistema.

Esta función se introdujo en Qt 6.9.

Véase también removeApplicationEmojiFontFamily, setApplicationEmojiFontFamilies(), applicationEmojiFontFamilies(), y addApplicationFallbackFontFamily().

[static, since 6.8] void QFontDatabase::addApplicationFallbackFontFamily(QChar::Script script, const QString &familyName)

Añade familyName como fuente alternativa definida por la aplicación para script.

Cuando Qt encuentre caracteres que no sean compatibles con la fuente seleccionada, buscará en una lista de fuentes de reserva para encontrar una que coincida con ellos. Esto garantiza que sea posible combinar varios caracteres en una sola cadena, aunque la fuente principal no los admita.

La lista de fuentes alternativas se selecciona en función del alfabeto de la cadena y de otras condiciones, como el idioma del sistema.

Aunque la lista de fuentes alternativas del sistema suele ser suficiente, hay casos en los que resulta útil anular el comportamiento predeterminado. Uno de estos casos es el uso de fuentes de aplicación como alternativa para garantizar la coherencia entre plataformas.

En otro caso, la aplicación puede estar escrita en un script con diferencias regionales y querer ejecutarla sin traducir en múltiples regiones. En este caso, podría ser útil reemplazar el fallback de la región local con uno que coincida con el idioma de la aplicación.

Al pasar familyName a addApplicationFallbackFontFamily(), ésta se convertirá en la familia preferida cuando se busquen caracteres que falten en script. script debe ser un script válido (QChar::Script_Latin o superior). Cuando se añadan múltiples fuentes para el mismo script, se priorizarán en orden inverso, de forma que la última familia añadida se comprobará primero y así sucesivamente.

Esta función se introdujo en Qt 6.8.

Véase también setApplicationFallbackFontFamilies(), removeApplicationFallbackFontFamily(), y applicationFallbackFontFamilies().

[static] int QFontDatabase::addApplicationFont(const QString &fileName)

Carga la fuente desde el archivo especificado por fileName y la pone a disposición de la aplicación. Se devuelve un ID que puede utilizarse para eliminar la fuente de nuevo con removeApplicationFont() o para recuperar la lista de nombres de familia que contiene la fuente.

La función devuelve -1 si no se ha podido cargar la fuente.

Actualmente sólo se soportan fuentes TrueType, colecciones de fuentes TrueType y fuentes OpenType.

Véase también addApplicationFontFromData(), applicationFontFamilies(), y removeApplicationFont().

[static] int QFontDatabase::addApplicationFontFromData(const QByteArray &fontData)

Carga la fuente a partir de los datos binarios especificados por fontData y la pone a disposición de la aplicación. Se devuelve un ID que puede utilizarse para eliminar la fuente de nuevo con removeApplicationFont() o para recuperar la lista de nombres de familia contenidos en la fuente.

La función devuelve -1 si no se ha podido cargar la fuente.

Actualmente sólo se soportan fuentes TrueType, colecciones de fuentes TrueType y fuentes OpenType.

Véase también addApplicationFont(), applicationFontFamilies(), y removeApplicationFont().

[static, since 6.9] QStringList QFontDatabase::applicationEmojiFontFamilies()

Devuelve la lista de familias de fuentes emoji definidas por la aplicación.

Esta función se introdujo en Qt 6.9.

Véase también addApplicationEmojiFontFamily(), removeApplicationEmojiFontFamily(), setApplicationEmojiFontFamilies(), y applicationFallbackFontFamilies().

[static, since 6.8] QStringList QFontDatabase::applicationFallbackFontFamilies(QChar::Script script)

Devuelve la lista de familias de fuentes fallback definidas por la aplicación previamente añadidas para script por la función addApplicationFallbackFontFamily().

Esta función se introdujo en Qt 6.8.

Véase también setApplicationFallbackFontFamilies(), addApplicationFallbackFontFamily() y removeApplicationFallbackFontFamily().

[static] QStringList QFontDatabase::applicationFontFamilies(int id)

Devuelve una lista de familias de fuentes para la fuente de aplicación dada identificada por id.

Véase también addApplicationFont() y addApplicationFontFromData().

[static] bool QFontDatabase::bold(const QString &family, const QString &style)

Devuelve true si la fuente que tiene familia family y estilo style es negrita; en caso contrario devuelve false.

Véase también italic() y weight().

[static] QStringList QFontDatabase::families(QFontDatabase::WritingSystem writingSystem = Any)

Devuelve una lista ordenada de las familias de fuentes disponibles compatibles con writingSystem.

Si una familia existe en varias fundiciones, el nombre devuelto para esa fuente tiene la forma "familia [fundición]". Ejemplos: "Times [Adobe]", "Times [Cronyx]", "Palatino".

Véase también writingSystems().

[static] QFont QFontDatabase::font(const QString &family, const QString &style, int pointSize)

Devuelve un objeto QFont que tiene la familia family, el estilo style y el tamaño de punto pointSize. Si no se ha podido crear una fuente coincidente, se devuelve un objeto QFont que utiliza la fuente predeterminada de la aplicación.

[static] bool QFontDatabase::isBitmapScalable(const QString &family, const QString &style = QString())

Devuelve true si la fuente que tiene la familia family y el estilo style es una fuente de mapa de bits escalable; en caso contrario devuelve false. Escalar una fuente de mapa de bits suele producir un resultado poco atractivo y poco legible, porque los píxeles de la fuente se escalan. Si necesita escalar una fuente bitmap es mejor escalarla a uno de los tamaños fijos devueltos por smoothSizes().

Véase también isScalable() y isSmoothlyScalable().

[static] bool QFontDatabase::isFixedPitch(const QString &family, const QString &style = QString())

Devuelve true si la fuente que tiene familia family y estilo style es de paso fijo; en caso contrario devuelve false.

[static] bool QFontDatabase::isPrivateFamily(const QString &family)

Devuelve true si y sólo si la familia de fuentes family es privada.

Esto ocurre, por ejemplo, en macOS e iOS, donde las fuentes de interfaz de usuario del sistema no son accesibles para el usuario. Para completar, QFontDatabase::families() devuelve todas las familias de fuentes, incluidas las privadas. Debería utilizar esta función si está desarrollando un control de selección de fuentes para mantener ocultas las fuentes privadas.

Véase también families().

[static] bool QFontDatabase::isScalable(const QString &family, const QString &style = QString())

Devuelve true si la fuente que tiene familia family y estilo style es escalable; en caso contrario devuelve false.

Véase también isBitmapScalable() y isSmoothlyScalable().

[static] bool QFontDatabase::isSmoothlyScalable(const QString &family, const QString &style = QString())

Devuelve true si la fuente que tiene familia family y estilo style es suavemente escalable; en caso contrario devuelve false. Si esta función devuelve true, es seguro escalar esta fuente a cualquier tamaño, y el resultado siempre será atractivo.

Véase también isScalable() y isBitmapScalable().

[static] bool QFontDatabase::italic(const QString &family, const QString &style)

Devuelve true si la fuente que tiene familia family y estilo style es cursiva; en caso contrario devuelve false.

Véase también weight() y bold().

[static] QList<int> QFontDatabase::pointSizes(const QString &family, const QString &styleName = QString())

Devuelve una lista de los tamaños de punto disponibles para la fuente que tiene la familia family y el estilo styleName. La lista puede estar vacía.

Véase también smoothSizes() y standardSizes().

[static] bool QFontDatabase::removeAllApplicationFonts()

Elimina todas las fuentes locales de la aplicación añadidas previamente mediante addApplicationFont() y addApplicationFontFromData().

Devuelve true si la descarga de las fuentes tuvo éxito; en caso contrario devuelve false.

Véase también removeApplicationFont(), addApplicationFont() y addApplicationFontFromData().

[static, since 6.9] bool QFontDatabase::removeApplicationEmojiFontFamily(const QString &familyName)

Elimina familyName de la lista de fuentes emoji definidas por la aplicación, siempre que se haya añadido previamente con addApplicationEmojiFontFamily().

Devuelve true si el nombre de la familia estaba en la lista y false en caso contrario.

Esta función se introdujo en Qt 6.9.

Véase también addApplicationEmojiFontFamily(), setApplicationEmojiFontFamilies(), applicationEmojiFontFamilies(), y removeApplicationFallbackFontFamily().

[static, since 6.8] bool QFontDatabase::removeApplicationFallbackFontFamily(QChar::Script script, const QString &familyName)

Elimina familyName de la lista de fuentes de reserva definidas por la aplicación para script, siempre que se haya añadido previamente con addApplicationFallbackFontFamily().

Devuelve true si el nombre de la familia estaba en la lista y false si no lo estaba.

Esta función se introdujo en Qt 6.8.

Véase también addApplicationFallbackFontFamily(), setApplicationFallbackFontFamilies(), y applicationFallbackFontFamilies().

[static] bool QFontDatabase::removeApplicationFont(int id)

Elimina la fuente de aplicación previamente cargada identificada por id. Devuelve true si la descarga de la fuente se ha realizado correctamente; en caso contrario, devuelve false.

Véase también removeAllApplicationFonts(), addApplicationFont() y addApplicationFontFromData().

[static, since 6.9] void QFontDatabase::setApplicationEmojiFontFamilies(const QStringList &familyNames)

Establece la lista de fuentes emoji definidas por la aplicación en familyNames.

Esta función se introdujo en Qt 6.9.

Véase también addApplicationEmojiFontFamily(), removeApplicationEmojiFontFamily(), applicationEmojiFontFamilies(), y setApplicationFallbackFontFamilies().

[static, since 6.8] void QFontDatabase::setApplicationFallbackFontFamilies(QChar::Script script, const QStringList &familyNames)

Establece la lista de fuentes de reserva definidas por la aplicación para script en familyNames.

Cuando Qt encuentra un carácter en script que no es soportado por la fuente actual, comprobará las familias en familyNames, en orden del primero al último, hasta que encuentre una coincidencia. Véase addApplicationFallbackFontFamily() para más detalles.

Esta función sobrescribe la lista actual de fuentes alternativas definidas por la aplicación para script.

Esta función se introdujo en Qt 6.8.

Véase también addApplicationFallbackFontFamily(), removeApplicationFallbackFontFamily(), y applicationFallbackFontFamilies().

[static] QList<int> QFontDatabase::smoothSizes(const QString &family, const QString &styleName)

Devuelve los tamaños de punto de una fuente que tenga la familia family y el estilo styleName que resulten atractivos. La lista puede estar vacía. Para fuentes no escalables y fuentes escalables de mapa de bits, esta función es equivalente a pointSizes().

Véase también pointSizes() y standardSizes().

[static] QList<int> QFontDatabase::standardSizes()

Devuelve una lista de tamaños de fuente estándar.

Véase también smoothSizes() y pointSizes().

[static] QString QFontDatabase::styleString(const QFont &font)

Devuelve una cadena que describe el estilo de font. Por ejemplo, "Negrita cursiva", "Negrita", "Cursiva" o "Normal". Se puede devolver una cadena vacía.

[static] QString QFontDatabase::styleString(const QFontInfo &fontInfo)

Devuelve una cadena que describe el estilo de fontInfo. Por ejemplo, "Negrita cursiva", "Negrita", "Cursiva" o "Normal". Se puede devolver una cadena vacía.

[static] QStringList QFontDatabase::styles(const QString &family)

Devuelve una lista de los estilos disponibles para la familia tipográfica family. Algunos estilos de ejemplo: "Ligera", "Ligera cursiva", "Negrita", "Oblicua", "Demi". La lista puede estar vacía.

Véase también families().

[static] QFont QFontDatabase::systemFont(QFontDatabase::SystemFont type)

Devuelve la fuente más adecuada para un caso dado de type para una correcta integración con el aspecto del sistema.

Véase también QGuiApplication::font().

[static] int QFontDatabase::weight(const QString &family, const QString &style)

Devuelve el peso de la fuente que tiene la familia family y el estilo style. Si no existe tal combinación de familia y estilo, devuelve -1.

Véase también italic() y bold().

[static] QString QFontDatabase::writingSystemName(QFontDatabase::WritingSystem writingSystem)

Devuelve los nombres de los writingSystem (por ejemplo, para mostrar al usuario en un cuadro de diálogo).

[static] QString QFontDatabase::writingSystemSample(QFontDatabase::WritingSystem writingSystem)

Devuelve una cadena con caracteres de muestra de writingSystem.

[static] QList<QFontDatabase::WritingSystem> QFontDatabase::writingSystems()

Devuelve una lista ordenada de los sistemas de escritura disponibles. Se trata de una lista generada a partir de información sobre todas las fuentes instaladas en el sistema.

Véase también families().

[static] QList<QFontDatabase::WritingSystem> QFontDatabase::writingSystems(const QString &family)

Devuelve una lista ordenada de los sistemas de escritura soportados por una fuente dada family.

Véase también families().