En esta página

PathText QML Type

Define una cadena con una fuente determinada. Más...

Import Statement: import QtQuick
Since: QtQuick 2.15

Propiedades

Descripción detallada

Este elemento define la forma de una cadena de texto especificada con una fuente determinada. La línea de base del texto se traducirá a las coordenadas x e y, y los contornos de la fuente se añadirán a la ruta en consecuencia.

Cuando se utilice para representar textos en un elemento «Shape», ten en cuenta lo siguiente:

  • Para que el relleno sea correcto, la propiedad «fillRule» de « ShapePath » debe establecerse en « ShapePath.WindingFill».
  • No todas las fuentes proporcionan un contorno adecuado para trazar contornos. Si desea un contorno trazado y obtiene resultados insatisfactorios, pruebe con otra fuente.
PathText {
    x: 0
    y: font.pixelSize
    font.family: "Arial"
    font.pixelSize: 100
    text: "Foobar"
}

Véase también Path, QPainterPath::setFillRule, PathPolyline, PathQuad, PathCubic, PathArc, PathAngleArc, PathCurve, PathSvg y PathMove.

Documentación de la propiedad

font.bold : bool

Establece si el grosor de la fuente es negrita.

font.capitalization : enumeration

Establece las mayúsculas del texto.

ConstanteDescripción
Font.MixedCaseel caso normal: no se aplica ningún cambio en el uso de mayúsculas
Font.AllUppercasemodifica el texto para que se muestre todo 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 }

font.contextFontMerging : bool [since 6.8]

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

Esto significa que, en ciertos casos poco habituales, pueden utilizarse muchas fuentes diferentes para representar una misma cadena de texto, incluso si pertenece al mismo alfabeto. Al establecer ` contextFontMerging ` en «true», se intentará encontrar, en su lugar, 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.

font.family : string

Establece el nombre de la familia de la fuente.

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.

font.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 dar soporte a 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 determinadas 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 debe utilizar.

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

Si una fuente es compatible con la característica « frac », se puede habilitar 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 la fuente en función de otras propiedades de la misma. En concreto, la característica « kern » se activará o desactivará dependiendo de la propiedad « font::kerning ». Además, todas las características de ligaduras (liga, clig,

dlig, hlig) se desactivarán si se establece font.letterSpacing, pero solo para 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 habilitado, 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().

font.italic : bool

Establece si la fuente tiene estilo cursivo.

font.kerning : bool

Activa o desactiva la característica 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 por defecto es « true ».

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

font.letterSpacing : real

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

font.pixelSize : int

Establece el tamaño de la fuente en píxeles.

El uso de esta función hace que la fuente dependa del dispositivo. Utiliza ` pointSize ` para establecer el tamaño de la fuente de forma independiente del dispositivo.

font.pointSize : real

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

font.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 }

font.preferTypoLineMetrics : bool [since 6.8]

Conjuntos alternativos de métricas de línea vertical que proporcionan los valores ascent, descent y leading de la fuente. A menudo se denominan 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 activado 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 el caso de determinadas fuentes, las métricas « win » pueden ser mayores que el interlineado preferible y el indicador « USE_TYPO_METRICS » puede estar desactivado por error. Para este tipo de 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 ».

font.strikeout : bool

Establece si la fuente tiene estilo tachado.

font.styleName : string

Establece 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 seleccionará en función del nombre del estilo, en lugar de las propiedades de fuente font.weight, font.bold y font.italic.

font.underline : bool

Establece si el texto aparece subrayado.

font.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 expresan como valores de punto 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 oscilar entre 100 y 900 (QFont::Thin a QFont::Black), mientras que «ital» puede oscilar entre 0 y 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 » ().

font.weight : int

Establece el grosor de la fuente.

El grosor puede ser uno de los siguientes:

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

font.wordSpacing : real

Establece el espaciado entre palabras de la fuente.

El espaciado entre palabras modifica el espaciado predeterminado entre 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.

text : string

El texto al que remite este enlace PathText debería contener los esquemas.

x : real

La posición horizontal de la línea de fondo del « PathText ».

y : real

La posición vertical de la línea de base del elemento ` PathText`.

Nota: Esta propiedad se refiere a la posición de la línea de base del texto, no a la parte superior de su cuadro delimitador. Esto puede causar cierta confusión, por ejemplo, al utilizar el elemento ` PathText ` con formas de ` Qt Quick `. Consulte FontMetrics para obtener información sobre cómo obtener la altura de ascendente de una fuente, lo cual puede utilizarse para desplazar el texto a la posición esperada.

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