En esta página

font QML Value Type

un valor de fuente con las propiedades de QFont. El tipo « font » hace referencia a un valor de fuente con las propiedades de QFont. Más...

Import Statement: import QtQuick

Propiedades

Descripción detallada

Las propiedades de tipo « font » adoptan por defecto el valor predeterminado de la aplicación « font ».

Ejemplo:

    Text {
        font.family: "Helvetica"
        font.pointSize: 13
        font.bold: true
    }

Dado que font es un tipo structured value, también se puede crear a partir de un objeto JavaScript:

    readonly property font myFont: ({
        family: "Helvetica",
        pointSize: 13,
        bold: true
    })

Al integrar con C++, ten en cuenta que cualquier valor de tipo ` QFont ` pasado a QML desde C++ se convierte automáticamente en un valor de tipo ` font `, y viceversa.

Este tipo de valor se proporciona mediante la importación QtQuick.

Véase también Tipos de valor de QML.

Documentación de propiedades

bold : bool

Si el peso de la fuente es negrita.

capitalization : enumeration

Las mayúsculas en un texto.

ConstanteDescripción
Font.MixedCaseel caso normal: no se aplica ningún cambio en las mayúsculas
Font.AllUppercasemodifica el texto para que se muestre íntegramente en mayúsculas
Font.AllLowercasemodifica el texto para que se muestre todo en minúsculas
Font.SmallCapsmodifica el texto para que se muestre en versalitas
Font.Capitalizemodifica el texto para que se muestre con la primera letra de cada palabra en mayúscula
Text { text: "Hello"; font.capitalization: Font.AllLowercase }

contextFontMerging : bool [since 6.8]

Si la fuente seleccionada no contiene un carácter concreto, Qt elige automáticamente una fuente alternativa de aspecto similar que sí contenga dicho carácter. Por defecto, esto se realiza carácter por carácter.

Esto significa que, en algunos casos poco habituales, pueden utilizarse muchas fuentes diferentes para representar una misma cadena de texto, aunque sea del mismo alfabeto. Al establecer ` contextFontMerging ` en «true», se intentará encontrar la fuente alternativa que coincida con el mayor subconjunto de la cadena de entrada. Esto supondrá un mayor coste para las cadenas en las que falten glifos, pero puede ofrecer resultados más coherentes. Por defecto, ` contextFontMerging ` tiene el valor « false ».

Esta propiedad se introdujo en Qt 6.8.

Véase también QFont::StyleStrategy.

family : string

El nombre de la familia tipográfica.

El nombre de la familia no distingue entre mayúsculas y minúsculas y puede incluir, opcionalmente, el nombre de la fundición, por ejemplo, «Helvetica [Cronyx]». Si la familia está disponible en más de una fundición tipográfica y no se especifica ninguna, se elige una fundición al azar. Si la familia no está disponible, se establecerá una utilizando el algoritmo de coincidencia de fuentes.

features : object [since 6.6]

Aplica valores enteros a características específicas de OpenType al dar forma al texto en función del contenido. Esto proporciona un acceso avanzado al proceso de modelado de la fuente y puede utilizarse para admitir características de fuente que, de otro modo, no estarían cubiertas por la API.

Las características de la fuente se representan mediante una correspondencia entre etiquetas de cuatro letras y valores enteros. Este valor entero, que en la mayoría de los casos se pasa junto con la etiqueta, representa un valor booleano: un valor cero significa que la característica está desactivada, y un valor distinto de cero significa que está activada. Sin embargo, en el caso de ciertas características de fuente, puede tener otras interpretaciones. Por ejemplo, cuando se aplica a la característica « salt », el valor es un índice que especifica la alternativa estilística que se va a utilizar.

Por ejemplo, la función tipográfica « frac » convertirá las fracciones diagonales separadas por una barra (como 1/2) en una representación diferente. Normalmente, esto implicará integrar la fracción completa en un solo ancho de carácter (como ½).

Si una fuente es compatible con la característica « frac », se puede activar en el shaper tal y como se muestra en el siguiente código:

Text {
    text: "One divided by two is 1/2"
    font.family: "MyFractionFont"
    font.features: { "frac": 1 }
}

Se pueden asignar valores a varias características en la misma asignación. Por ejemplo, si también deseas desactivar el kerning de la fuente, puedes desactivarlo explícitamente de la siguiente manera:

Text {
    text: "One divided by two is 1/2"
    font.family: "MyFractionFont"
    font.features: { "frac": 1, "kern": 0 }
}

También puedes recopilar las propiedades de la fuente en un objeto:

Text {
    text: "One divided by two is 1/2"
    font: {
        family: "MyFractionFont"
        features: { "frac": 1, "kern": 0 }
    }
}

Nota: Por defecto, Qt activará y desactivará ciertas características de fuente en función de otras propiedades de la misma. En concreto, la característica « kern » se activará o desactivará en función de la propiedad « font::kerning ». Además, todas las características de ligaduras (liga, clig,

dlig, hlig) se desactivarán si se establece un valor para font.letterSpacing, pero solo en los sistemas de escritura en los que el uso de ligaduras es meramente estético. En los sistemas de escritura en los que las ligaduras son obligatorias, las funciones permanecerán en su estado predeterminado. Los valores establecidos mediante font.features anularán el comportamiento predeterminado. Si, por ejemplo, "kern" se establece en 1, el kerning estará siempre activado, independientemente de si la propiedad font::kerning está establecida en false. Del mismo modo,

si se establece en 0, siempre estará desactivado.

Esta propiedad se introdujo en Qt 6.6.

Véase también QFont::setFeature().

hintingPreference : enumeration

El ajuste de contornos preferido para el texto.

Se trata de una indicación para que el sistema de renderizado de texto subyacente utilice un determinado nivel de hinting, y su compatibilidad varía según las plataformas. Consulte la tabla de la documentación de QFont::HintingPreference para obtener más detalles.

Nota: Esta propiedad solo surte efecto cuando se utiliza junto con el tipo de representación Text.NativeRendering.

ConstanteDescripción
Font.PreferDefaultHintingUtiliza el nivel de hinting predeterminado para la plataforma de destino.
Font.PreferNoHintingSi es posible, representa el texto sin aplicar hinting a los contornos de los glifos. La composición tipográfica del texto será precisa, utilizando las mismas métricas que se emplean, por ejemplo, en la impresión.
Font.PreferVerticalHintingSi es posible, renderiza el texto sin hinting horizontal, pero alinea los glifos con la cuadrícula de píxeles en dirección vertical. El texto aparecerá más nítido en pantallas cuya densidad sea demasiado baja para ofrecer una representación precisa de los glifos. Sin embargo, dado que las métricas horizontales de los glifos no están ajustadas, la maquetación del texto será escalable a dispositivos de mayor densidad (como impresoras) sin que se vean afectados detalles como los saltos de línea.
Font.PreferFullHintingSi es posible, representa el texto con hinting tanto en dirección horizontal como vertical. El texto se modificará para optimizar la legibilidad en el dispositivo de destino, pero, dado que las métricas dependerán del tamaño de destino del texto, las posiciones de los glifos, los saltos de línea y otros detalles tipográficos no se adaptarán, lo que significa que el diseño del texto puede verse diferente en dispositivos con distintas densidades de píxeles.
Text { text: "Hello"; renderType: Text.NativeRendering; font.hintingPreference: Font.PreferVerticalHinting }

italic : bool

Si la fuente tiene estilo cursivo.

kerning : bool

Activa o desactiva la función OpenType de kerning al dar forma al texto. Desactivarla puede mejorar el rendimiento al crear o modificar el texto, aunque a costa de perder algunas características estéticas. El valor predeterminado es « true ».

Text { text: "OATS FLAVOUR WAY"; font.kerning: false }

letterSpacing : real

El espaciado entre letras de la fuente.

El espaciado entre letras modifica el espaciado predeterminado entre las letras individuales de la fuente. Un valor positivo aumenta el espaciado entre letras en los píxeles correspondientes; un valor negativo lo reduce.

pixelSize : int

El tamaño de la fuente en píxeles.

Hace que la fuente dependa del dispositivo. Utiliza ` pointSize ` para establecer el tamaño de la fuente de forma independiente del dispositivo.

pointSize : real

El tamaño de la fuente en puntos. El tamaño en puntos debe ser mayor que cero.

preferShaping : bool

A veces, una fuente aplica reglas complejas a un conjunto de caracteres para que se muestren correctamente. En algunos sistemas de escritura, como las escrituras brahmicas, esto es necesario para que el texto sea legible, pero en la escritura latina, por ejemplo, se trata simplemente de una característica estética. Al establecer la propiedad « preferShaping » en «false», se desactivarán todas estas características cuando no sean necesarias, lo que mejorará el rendimiento en la mayoría de los casos.

El valor por defecto es « true ».

Text { text: "Some text"; font.preferShaping: false }

preferTypoLineMetrics : bool [since 6.8]

Conjuntos alternativos de métricas de línea vertical que proporcionan el ascent, descent y leading de la fuente. A menudo se las denomina métricas «win» (de Windows) y métricas «typo» (tipográficas). Aunque la especificación recomienda utilizar las métricas typo para el interlineado, muchas aplicaciones prefieren las métricas win, a menos que se haya establecido el indicador USE_TYPO_METRICS en el campo fsSelection de la fuente. Por motivos de compatibilidad con versiones anteriores, esto también es así en el caso de las aplicaciones Qt. Esto no supone ningún problema para las fuentes que establecen el indicador « USE_TYPO_METRICS » para indicar que las métricas « typo » son válidas, ni para aquellas en las que las métricas « win » y « typo » coinciden. Sin embargo, en determinadas fuentes, las métricas « win » pueden ser mayores que el interlineado preferible y el indicador « USE_TYPO_METRICS » puede estar desactivado por error. En el caso de estas fuentes, establecer « font.preferTypoLineMetrics » puede ofrecer mejores resultados.

Por defecto, ` preferTypoLineMetrics ` es ` false`.

Esta propiedad se introdujo en Qt 6.8.

Véase también QFont::StyleStrategy.

strikeout : bool

Si la fuente tiene estilo tachado.

styleName : string

El nombre del estilo de la fuente.

El nombre del estilo no distingue entre mayúsculas y minúsculas. Si se establece, la fuente se buscará por el nombre del estilo en lugar de por las propiedades de fuente font.weight, font.bold y font.italic.

underline : bool

Si el texto está subrayado.

variableAxes : object [since 6.7]

Aplica valores de coma flotante a los ejes variables en las fuentes variables.

Las fuentes variables permiten almacenar múltiples variaciones (con diferentes grosores, anchos o estilos) en un mismo archivo de fuente. Las variaciones se especifican como valores de coma flotante para un conjunto predefinido de parámetros, denominados «ejes variables». El diseñador de la fuente suele asignar nombres a las instancias específicas y, en Qt, estas se pueden seleccionar mediante setStyleName(), al igual que las subfamilias tradicionales.

En algunos casos, también resulta útil proporcionar valores arbitrarios para los diferentes ejes. Por ejemplo, si una fuente tiene una subfamilia Regular y otra Negrita, es posible que se desee un grosor intermedio entre ambas. En ese caso, se podría solicitar manualmente proporcionando un valor personalizado para el eje «wght» de la fuente.

Text {
    text: "Foobar"
    font.family: "MyVariableFont"
    font.variableAxes: { "wght": (Font.Normal + Font.Bold) / 2.0 }
}

Si la fuente admite el eje «wght» y el valor proporcionado se encuentra dentro de su rango definido, se proporcionará una fuente correspondiente al peso 550,0.

Existen algunos ejes estándar que ofrecen muchas fuentes, como «wght» (peso), «wdth» (anchura), «ital» (cursiva) y «opsz» (tamaño óptico). Cada uno de ellos tiene rangos individuales definidos en la propia fuente. Por ejemplo, «wght» puede abarcar de 100 a 900 (QFont::Thin a QFont::Black), mientras que «ital» puede abarcar de 0 a 1 (de no cursiva a totalmente cursiva).

Una fuente también puede optar por definir ejes personalizados; la única limitación es que el nombre debe cumplir los requisitos de un QFont::Tag (secuencia de cuatro caracteres Latin-1).

Por defecto, no se establecen ejes variables.

Nota: En Windows, los ejes variables no son compatibles si se utiliza el backend de fuentes GDI opcional.

Esta propiedad se introdujo en Qt 6.7.

Véase también QFont::setVariableAxis().

weight : int

El grosor de la fuente solicitado. El grosor solicitado debe ser un número entero comprendido entre 1 y 1000, o uno de los valores predefinidos:

ConstanteDescripción
Font.Thin100
Font.ExtraLight200
Font.Light300
Font.Normal400 (por defecto)
Font.Medium500
Font.DemiBold600
Font.Bold700
Font.ExtraBold800
Font.Black900
Text { text: "Hello"; font.weight: Font.DemiBold }

wordSpacing : real

El espaciado entre palabras de la fuente.

El espaciado entre palabras modifica el espaciado predeterminado entre las palabras individuales. Un valor positivo aumenta el espaciado entre palabras en la cantidad correspondiente de píxeles, mientras que un valor negativo lo reduce en la misma medida.

© 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.