PathText QML Type
Define una cadena con una fuente determinada. Más...
| Import Statement: | import QtQuick |
| Since: | QtQuick 2.15 |
Propiedades
- font.bold : bool
- font.capitalization : enumeration
- font.contextFontMerging : bool
(since 6.8) - font.family : string
- font.features : object
(since 6.6) - font.italic : bool
- font.kerning : bool
- font.letterSpacing : real
- font.pixelSize : int
- font.pointSize : real
- font.preferShaping : bool
- font.preferTypoLineMetrics : bool
(since 6.8) - font.strikeout : bool
- font.styleName : string
- font.underline : bool
- font.variableAxes : object
(since 6.7) - font.weight : int
- font.wordSpacing : real
- text : string
- x : real
- y : real
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.
| Constante | Descripción |
|---|---|
Font.MixedCase | el caso normal: no se aplica ningún cambio en el uso de mayúsculas |
Font.AllUppercase | modifica el texto para que se muestre todo en mayúsculas |
Font.AllLowercase | modifica el texto para que se muestre todo en minúsculas |
Font.SmallCaps | modifica el texto para que se muestre en versalitas |
Font.Capitalize | modifica el texto para que se muestre con la primera letra de cada palabra en mayúscula |
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:
| Constante | Descripción |
|---|---|
Font.Thin | 100 |
Font.ExtraLight | 200 |
Font.Light | 300 |
Font.Normal | 400 (por defecto) |
Font.Medium | 500 |
Font.DemiBold | 600 |
Font.Bold | 700 |
Font.ExtraBold | 800 |
Font.Black | 900 |
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.