Text QML Type
Especifica cómo añadir texto con formato a una escena. Más...
Propiedades
- advance : size
- antialiasing : bool
- baseUrl : url
- bottomPadding : real
- clip : bool
- color : color
- contentHeight : real
- contentWidth : real
- effectiveHorizontalAlignment : enumeration
- elide : enumeration
- font.bold : bool
- font.capitalization : enumeration
- font.contextFontMerging : bool
(since 6.8) - font.family : string
- font.features : object
(since 6.6) - font.hintingPreference : enumeration
- 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
- fontInfo.bold : bool
- fontInfo.family : string
- fontInfo.italic : bool
- fontInfo.pixelSize : int
- fontInfo.pointSize : real
- fontInfo.styleName : string
- fontInfo.weight : int
- fontSizeMode : enumeration
- horizontalAlignment : enumeration
- hoveredLink : string
- leftPadding : real
- lineCount : int
- lineHeight : real
- lineHeightMode : enumeration
- linkColor : color
- maximumLineCount : int
- minimumPixelSize : int
- minimumPointSize : int
- padding : real
- renderType : enumeration
- renderTypeQuality : int
(since 6.0) - rightPadding : real
- style : enumeration
- styleColor : color
- text : string
- textFormat : enumeration
- topPadding : real
- truncated : bool
- verticalAlignment : enumeration
- wrapMode : enumeration
Señales
- lineLaidOut(object line)
- linkActivated(string link)
- linkHovered(string link)
Métodos
- void forceLayout()
- string linkAt(real x, real y)
Descripción detallada
Los elementos de texto pueden mostrar tanto texto sin formato como texto con formato. Por ejemplo, puedes definir texto en rojo con una fuente y un tamaño específicos de la siguiente manera:
Text {
text: "Hello World!"
font.family: "Helvetica"
font.pointSize: 24
color: "red"
}Utiliza el marcado de estilo HTML o Markdown para definir texto con formato:
Text {
text: "<b>Hello</b> <i>World!</i>"
}Text {
text: "**Hello** *World!*"
}
Si no se especifican explícitamente la altura y la anchura, Text intentará determinar el espacio necesario y lo ajustará en consecuencia. A menos que se haya establecido la propiedad « wrapMode », siempre dará prioridad a la anchura sobre la altura (todo el texto se colocará en una sola línea).
Para ajustar una sola línea de texto sin formato a un ancho determinado, puedes utilizar la propiedad « elide ».
Nota: El subconjunto de HTML compatible es limitado. No pretende cumplir con el estándar HTML, sino que se proporciona como una facilidad para aplicar estilos a las etiquetas de texto. Además, si el texto contiene etiquetas HTML ` img ` que cargan imágenes remotas, el texto se recargará.
«Text» proporciona texto de solo lectura. Para texto editable, véase « TextEdit ».
Advertencia: De forma predeterminada, el componente «Texto» detectará el tipo de contenido ( textFormat ) en función del contenido de text. Si se determina que es Text.StyledText o Text.MarkdownText, el componente «Texto» admitirá funciones de texto enriquecido, como el cambio de colores, estilos de fuente e imágenes en línea. Esta funcionalidad incluye la carga remota de imágenes a través de la red. Por lo tanto, al mostrar contenido no fiable controlado por el usuario, el atributo « textFormat » debe establecerse explícitamente en « Text.PlainText », o bien deben eliminarse las etiquetas no deseadas del contenido.
Véase también el ejemplo de fuentes.
Documentación de propiedades
advance : size [read-only]
La distancia, en píxeles, desde el origen de la línea de base del primer carácter del elemento de texto hasta el origen de la línea de base del primer carácter de un elemento de texto que aparece inmediatamente después de este en el flujo de texto.
Ten en cuenta que el avance puede ser negativo si el texto fluye de derecha a izquierda.
antialiasing : bool
Se utiliza para determinar si el texto debe aplicar suavizado o no. Solo el texto con el valor « renderType » de «Text.NativeRendering» puede desactivar el suavizado.
El valor predeterminado es « true ».
baseUrl : url
Esta propiedad especifica una URL base que se utiliza para resolver las URL relativas que aparecen en el texto.
Las URL se resuelven de modo que se consideren dentro del mismo directorio que el destino de la URL base, lo que significa que se ignorará cualquier parte de la ruta que se encuentre después de la última «/».
| URL base | URL relativa | URL resuelta |
|---|---|---|
| http://qt-project.org/ | images/logo.png | http://qt-project.org/images/logo.png |
| http://qt-project.org/index.html | images/logo.png | http://qt-project.org/images/logo.png |
| http://qt-project.org/content | images/logo.png | http://qt-project.org/content/images/logo.png |
| http://qt-project.org/content/ | images/logo.png | http://qt-project.org/content/images/logo.png |
| http://qt-project.org/content/index.html | images/logo.png | http://qt-project.org/content/images/logo.png |
| http://qt-project.org/content/index.html | ../images/logo.png | http://qt-project.org/images/logo.png |
| http://qt-project.org/content/index.html | /images/logo.png | http://qt-project.org/images/logo.png |
El valor por defecto es la URL del archivo QML que instancia el elemento Text.
Estas propiedades definen el relleno que rodea el contenido. Este espacio se reserva además de los valores de « contentWidth » y « contentHeight ».
clip : bool
Esta propiedad se mantiene independientemente de si el texto está recortado.
Ten en cuenta que, si el texto no cabe en el rectángulo delimitador, se cortará bruscamente.
Si deseas mostrar un texto que pueda ser extenso en un espacio limitado, probablemente te convenga utilizar en su lugar la opción « elide ».
color : color
El color del texto.
Un ejemplo de texto en verde definido mediante notación hexadecimal:
Text {
color: "#00FF00"
text: "green text"
}Un ejemplo de texto en azul acero definido mediante un nombre de color SVG:
Text {
color: "steelblue"
text: "blue text"
}contentHeight : real [read-only]
Devuelve la altura del texto, incluida la parte que sobresale de la altura prevista debido a que hay más texto del que cabe en la altura establecida.
contentWidth : real [read-only]
Devuelve la anchura del texto, incluida la parte que sobresale de la anchura cubierta debido a un ajuste de línea insuficiente, si se ha establecido el parámetro `WrapMode`.
effectiveHorizontalAlignment : enumeration [read-only]
horizontalAlignment : enumeration
verticalAlignment : enumeration
Establece la alineación horizontal y vertical del texto dentro del ancho y la altura de los elementos de texto. Por defecto, el texto se alinea verticalmente en la parte superior. La alineación horizontal sigue la alineación natural del texto; por ejemplo, el texto que se lee de izquierda a derecha se alineará a la izquierda.
Los valores válidos para ` horizontalAlignment ` son ` Text.AlignLeft`, ` Text.AlignRight`, ` Text.AlignHCenter ` y ` Text.AlignJustify`. Los valores válidos para ` verticalAlignment ` son ` Text.AlignTop`, ` Text.AlignBottom ` y ` Text.AlignVCenter`.
Tenga en cuenta que, para una sola línea de texto, el tamaño del texto es el área que ocupa. En este caso habitual, todas las alineaciones son equivalentes. Si desea que el texto quede, por ejemplo, centrado en su elemento padre, deberá modificar la propiedad Item::anchors o establecer horizontalAlignment en Text.AlignHCenter y vincular el ancho al del elemento padre.
Al utilizar la propiedad adjunta ` LayoutMirroring::enabled ` para reflejar los diseños de la aplicación, la alineación horizontal del texto también se reflejará. Sin embargo, la propiedad ` horizontalAlignment ` permanecerá sin cambios. Para consultar la alineación horizontal efectiva de `Text`, utiliza la propiedad de solo lectura ` effectiveHorizontalAlignment`.
elide : enumeration
Establece esta propiedad para que se omitan partes del texto y este se ajuste al ancho del elemento «Texto». El texto solo se omitirá si se ha establecido un ancho explícito.
Esta propiedad funciona con los formatos Text.PlainText y Text.StyledText, pero no se puede utilizar con los formatos Text.RichText ni Text.MarkdownText.
La elisión puede ser:
| Constante | Descripción |
|---|---|
Text.ElideNone | - el valor por defecto |
Text.ElideLeft | |
Text.ElideMiddle | |
Text.ElideRight |
Si esta propiedad se establece en «Text.ElideRight», se puede utilizar con texto « wrapped ». El texto solo se elidirá si se ha establecido « maximumLineCount » o « height ». Si se establecen tanto « maximumLineCount » como « height », se aplicará « maximumLineCount », a menos que las líneas no quepan en la altura permitida.
Si el texto es una cadena de longitud variable y el modo no es « Text.ElideNone », se utilizará la primera cadena que quepa; de lo contrario, se omitirá la última.
Las cadenas de longitud variable se ordenan de mayor a menor, separadas por el carácter Unicode «terminador de cadena» U009C (escríbelo en QML con "\u009C" o "\x9C").
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 las mayúsculas |
Font.AllUppercase | modifica el texto para que se muestre todo en mayúsculas |
Font.AllLowercase | modifica el texto para que se muestre 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 concreto, 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 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 determinadas características de la 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) 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 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 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().
font.hintingPreference : enumeration
Establece el «hinting» preferido para el texto.
Se trata de una indicación al sistema de representación de texto subyacente para que utilice un determinado nivel de ajuste, 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 renderizado ` Text.NativeRendering`.
| Constante | Descripción |
|---|---|
Font.PreferDefaultHinting | Utiliza el nivel de hinting predeterminado para la plataforma de destino. |
Font.PreferNoHinting | Si es posible, renderiza el texto sin aplicar «hinting» a los contornos de los glifos. La composición del texto será tipográficamente precisa, utilizando las mismas métricas que se emplean, por ejemplo, al imprimir. |
Font.PreferVerticalHinting | Si 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.PreferFullHinting | Si 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. |
font.italic : bool
Establece si la fuente tiene estilo cursivo.
font.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 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 mostrarlos 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 distintos de métricas de línea vertical que proporcionan el 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 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 un 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 preferido y el indicador « USE_TYPO_METRICS » puede estar desactivado por error. En tales 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 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 Bold, 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 unos 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 establece ningún eje variable.
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
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:
| 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.
fontInfo.bold : bool [read-only]
El estado «negrita» de la información de la fuente que se ha resuelto para la fuente actual y fontSizeMode. Esto es así si el grosor de la fuente resuelta es «negrita» o superior.
fontInfo.family : string [read-only]
El nombre de la familia tipográfica que se ha determinado para la fuente actual y fontSizeMode.
fontInfo.italic : bool [read-only]
El estado de la cursiva de la información de la fuente que se ha resuelto para la fuente actual y fontSizeMode.
fontInfo.pixelSize : int [read-only]
El tamaño en píxeles de la información de la fuente que se ha calculado para la fuente actual y fontSizeMode.
fontInfo.pointSize : real [read-only]
El valor «pointSize» de la información de la fuente que se ha determinado para la fuente actual y « fontSizeMode ».
fontInfo.styleName : string [read-only]
El nombre de estilo de la información de la fuente que se ha resuelto para la fuente actual y fontSizeMode.
fontInfo.weight : int [read-only]
El peso de la información de la fuente que se ha resuelto para la fuente actual y fontSizeMode.
fontSizeMode : enumeration
Esta propiedad especifica cómo se determina el tamaño de la fuente del texto mostrado. Los valores posibles son:
| Constante | Descripción |
|---|---|
Text.FixedSize | (por defecto) Se utiliza el tamaño especificado en « font.pixelSize » o « font.pointSize ». |
Text.HorizontalFit | Se utiliza el tamaño mayor, hasta el tamaño especificado, que quepa dentro del ancho del elemento sin que se produzca un salto de línea. |
Text.VerticalFit | Se utiliza el tamaño más grande, hasta el especificado, que quepa en la altura del elemento. |
Text.Fit | Se utiliza el tamaño máximo, hasta el especificado, que quepa dentro del ancho y la altura del elemento. |
El tamaño de fuente del texto ajustado tiene un límite mínimo especificado por la propiedad minimumPointSize o minimumPixelSize y un límite máximo especificado por las propiedades font.pointSize o font.pixelSize.
Text { text: "Hello"; fontSizeMode: Text.Fit; minimumPixelSize: 10; font.pixelSize: 72 }Si el texto no cabe dentro de los límites del elemento con el tamaño de fuente mínimo, se omitirá según lo establecido en la propiedad elide.
Si la propiedad ` textFormat ` se establece en ` Text.RichText`, esto no tendrá ningún efecto, ya que la propiedad se ignorará por completo. Si ` textFormat ` se establece en ` Text.StyledText`, entonces se respetará la propiedad siempre que no haya etiquetas de tamaño de fuente dentro del texto. Si hay etiquetas de tamaño de fuente, la propiedad seguirá respetándolas. Esto puede hacer que no se cumpla totalmente la configuración de `fontSizeMode`.
hoveredLink : string [read-only]
Esta propiedad contiene la cadena del enlace cuando el usuario pasa el cursor por encima de un enlace incrustado en el texto. El enlace debe estar en formato de texto enriquecido o HTML, y la cadena hoveredLink permite acceder a ese enlace concreto.
Véase también linkHovered y linkAt().
lineCount : int [read-only]
Devuelve el número de líneas visibles en el elemento de texto.
Esta propiedad no es compatible con el texto enriquecido.
Véase también maximumLineCount.
lineHeight : real
Establece la altura de línea del texto. El valor puede expresarse en píxeles o como un multiplicador, dependiendo de lineHeightMode.
El valor por defecto es un multiplicador de 1,0. La altura de línea debe ser un valor positivo.
lineHeightMode : enumeration
Esta propiedad determina cómo se especifica la altura de línea. Los valores posibles son:
| Constante | Descripción |
|---|---|
Text.ProportionalHeight | (por defecto) establece el espaciado de forma proporcional a la línea (como un multiplicador). Por ejemplo, si se establece en 2, se obtiene un doble interlineado. |
Text.FixedHeight | Establece la altura de línea en un valor fijo (en píxeles). |
linkColor : color
El color de los enlaces en el texto.
Esta propiedad funciona con el elemento `StyledText` textFormat, pero no con `RichText`. El color de los enlaces en `RichText` se puede especificar incluyendo etiquetas de estilo CSS en el texto.
maximumLineCount : int
Establece esta propiedad para limitar el número de líneas que mostrará el elemento de texto. Si «elide» se establece en «Text.ElideRight», el texto se truncará adecuadamente. Por defecto, este valor es el mayor entero posible.
Esta propiedad no es compatible con el texto enriquecido.
Véase también lineCount y elide.
minimumPixelSize : int
Esta propiedad especifica el tamaño mínimo en píxeles de la fuente del texto escalado mediante la propiedad « fontSizeMode ».
Si la propiedad « fontSizeMode » tiene el valor «Text.FixedSize» o la propiedad « font.pixelSize » tiene el valor -1, esta propiedad se ignora.
minimumPointSize : int
Esta propiedad especifica el tamaño mínimo de fuente ( size ) del texto escalado mediante la propiedad fontSizeMode.
Si el valor de « fontSizeMode » es «Text.FixedSize» o el valor de « font.pointSize » es -1, esta propiedad se ignora.
renderType : enumeration
Sobrescribir el tipo de representación predeterminado de este componente.
Los tipos de representación admitidos son:
| Constante | Descripción |
|---|---|
Text.QtRendering | El texto se representa utilizando un campo de distancia escalable para cada glifo. |
Text.NativeRendering | El texto se representa utilizando una técnica específica de la plataforma. |
Text.CurveRendering | El texto se renderiza utilizando un rasterizador de curvas que se ejecuta directamente en el hardware gráfico. (Introducido en Qt 6.7.0.) |
Selecciona « Text.NativeRendering » si prefieres que el texto tenga un aspecto nativo en la plataforma de destino y no necesitas funciones avanzadas, como la transformación del texto. El uso de dichas funciones en combinación con el tipo de representación «NativeRendering» dará lugar a resultados de mala calidad y, en ocasiones, pixelados.
Tanto « Text.QtRendering » como « Text.CurveRendering » son técnicas aceleradas por hardware. « QtRendering » es la más rápida de las dos, pero consume más memoria y presenta artefactos de renderizado en tamaños grandes. Se debe considerar « CurveRendering » como alternativa en los casos en los que « QtRendering » no ofrezca buenos resultados visuales o cuando la prioridad sea reducir el consumo de memoria gráfica.
El tipo de renderizado predeterminado viene determinado por QQuickWindow::textRenderType().
renderTypeQuality : int [since 6.0]
Sobrescribe la calidad predeterminada del tipo de representación de este componente. Se trata de una personalización de bajo nivel que puede ignorarse en la mayoría de los casos. Actualmente solo surte efecto cuando ` renderType ` tiene el valor ` Text.QtRendering`.
El algoritmo de rasterización utilizado por Text.QtRendering puede generar artefactos en textos de gran tamaño, como por ejemplo que las esquinas afiladas parezcan más redondeadas de lo que deberían. Si esto supone un problema para elementos de texto concretos, aumenta el valor de « renderTypeQuality » para mejorar la calidad de representación, a costa de un mayor consumo de memoria.
El valor de « renderTypeQuality » puede ser cualquier número entero mayor que 0, o uno de los siguientes valores predefinidos
| Constante | Descripción |
|---|---|
Text.DefaultRenderTypeQuality | -1 (por defecto) |
Text.LowRenderTypeQuality | 26 |
Text.NormalRenderTypeQuality | 52 |
Text.HighRenderTypeQuality | 104 |
Text.VeryHighRenderTypeQuality | 208 |
Esta propiedad se introdujo en Qt 6.0.
style : enumeration
Establece un estilo de texto adicional.
Los estilos de texto admitidos son:
| Constante | Descripción |
|---|---|
Text.Normal | - el predeterminado |
Text.Outline | |
Text.Raised | |
Text.Sunken | |

styleColor : color
Define el color secundario que utilizan los estilos de texto.
styleColor Se utiliza como color de contorno para el texto contorneado y como color de sombra para el texto en relieve o hundido. Si no se ha establecido ningún estilo, no se utiliza en absoluto.
Text { font.pointSize: 18; text: "hello"; style: Text.Raised; styleColor: "gray" }Véase también style.
text : string
El texto que se va a mostrar. El texto admite tanto cadenas de texto sin formato como de texto con formato.
El elemento intentará determinar automáticamente si el texto debe tratarse como texto con estilo. Esta determinación se realiza mediante la función Qt::mightBeRichText(). Sin embargo, la detección de Markdown no es automática.
Véase también textFormat.
textFormat : enumeration
La forma en que debe mostrarse la propiedad « text ».
Los formatos de texto admitidos son:
| Constante | Descripción |
|---|---|
Text.AutoText | (por defecto) detectado mediante la heurística ` Qt::mightBeRichText()` |
Text.PlainText | todas las etiquetas de estilo se tratan como texto sin formato |
Text.StyledText | texto enriquecido básico optimizado, como en HTML 3.2 |
Text.RichText | un subconjunto de HTML 4 |
Text.MarkdownText | CommonMark más las extensiones de GitHub para tablas y listas de tareas (desde la versión 5.14) |
Si el formato de texto es Text.AutoText, el elemento «Texto» determinará automáticamente si el texto debe tratarse como texto con estilo. Esta determinación se realiza mediante Qt::mightBeRichText(), que puede detectar la presencia de una etiqueta HTML en la primera línea de texto, pero no puede distinguir Markdown del texto sin formato.
Text.StyledText es un formato optimizado que admite algunas etiquetas básicas de estilo de texto, al estilo de HTML 3.2:
<b></b> - bold
<del></del> - strike out (removed content)
<s></s> - strike out (no longer accurate or no longer relevant content)
<strong></strong> - bold
<i></i> - italic
<br> - new line
<p> - paragraph
<u> - underlined text
<font color="color_name" size="1-7"></font>
<h1> to <h6> - headers
<a href=""> - anchor
<img src="" align="top,middle,bottom" width="" height=""> - inline images
<ol type="">, <ul type=""> and <li> - ordered and unordered lists
<pre></pre> - preformatted
All entitiesText.StyledText El analizador es estricto y exige que las etiquetas estén correctamente anidadas.
|
|
Text.RichText admite un subconjunto más amplio de HTML 4, tal y como se describe en la página «Subconjunto de HTML admitido ». Se recomienda utilizar en su lugar Text.PlainText, Text.StyledText o Text.MarkdownText, ya que ofrecen un mejor rendimiento.
Nota: Con Text.MarkdownText y con el subconjunto de HTML compatible, algunos elementos decorativos no se representan tal y como lo harían en un navegador web:
- los bloques de código utilizan el default monospace font, pero sin un recuadro de resaltado a su alrededor
- las citas en bloque están sangradas, pero no hay una línea vertical junto a la cita
Advertencia: Cuando el formato de texto es distinto de ` Text.PlainText`, admitirá funciones de texto enriquecido, como el cambio de colores, estilos de fuente e imágenes en línea. Esto incluye la carga remota de imágenes a través de la red. Por lo tanto, al mostrar contenido no fiable controlado por el usuario, el `textFormat` debe establecerse explícitamente en ` Text.PlainText`, o bien deben eliminarse las etiquetas no deseadas del contenido.
truncated : bool [read-only]
Devuelve «true» si el texto se ha truncado debido a maximumLineCount o elide.
Esta propiedad no es compatible con el texto enriquecido.
Véase también maximumLineCount y elide.
wrapMode : enumeration
Establece esta propiedad para que el texto se ajuste al ancho del elemento «Text». El texto solo se ajustará si se ha establecido un ancho explícito. «wrapMode» puede tomar uno de los siguientes valores:
| Constante | Descripción |
|---|---|
Text.NoWrap | (por defecto) no se realizará ningún ajuste. Si el texto no contiene suficientes saltos de línea, « contentWidth » superará el ancho establecido. |
Text.WordWrap | El ajuste se realiza únicamente en los límites de las palabras. Si una palabra es demasiado larga, contentWidth sobrepasará el ancho establecido. |
Text.WrapAnywhere | El ajuste se realiza en cualquier punto de una línea, incluso si se produce en medio de una palabra. |
Text.Wrap | Si es posible, el ajuste de línea se realiza en el límite de una palabra; de lo contrario, se realizará en el punto adecuado de la línea, incluso en medio de una palabra. |
Documentación de Signal
lineLaidOut(object line)
Esta señal se emite por cada línea de texto que se maquet line e durante el proceso de maquetación, tanto en modo de texto sin formato como en modo de texto con estilo. No se emite en modo de texto enriquecido. El objeto de texto sin formato especificado proporciona más detalles sobre la línea que se está maquetando en ese momento.
Esto permite posicionar y cambiar el tamaño de una línea mientras se está maquetando. Se puede utilizar, por ejemplo, para crear columnas o maquetar texto alrededor de objetos.
Las propiedades del objeto ` line ` especificado son:
| Nombre de la propiedad | Descripción |
|---|---|
| número (solo lectura) | Número de línea, que comienza por cero. |
| x | Especifica la posición x de la línea dentro del elemento Text. |
| y | Especifica la posición y de la línea dentro del elemento ` Text `. |
| anchura | Especifica el ancho de la línea. |
| height | Especifica la altura de la línea. |
| implicitWidth (solo lectura) | El ancho que la línea ocuparía de forma natural en función de su contenido, sin tener en cuenta ninguna modificación realizada en el ancho. |
| isLast (solo lectura) | Indica si la línea es la última. Esta propiedad puede cambiar si se establece la propiedad «width» en un valor diferente. |
Por ejemplo, esto desplazará las primeras 5 líneas de un elemento Text 100 píxeles hacia la derecha:
onLineLaidOut: (line)=> {
if (line.number < 5) {
line.x = line.x + 100
line.width = line.width - 100
}
}El siguiente ejemplo te permitirá colocar un elemento al final de la última línea:
onLineLaidOut: (line)=> {
if (line.isLast) {
lastLineMarker.x = line.x + line.implicitWidth
lastLineMarker.y = line.y + (line.height - lastLineMarker.height) / 2
}
}Nota: El controlador correspondiente es onLineLaidOut.
linkActivated(string link)
Esta señal se emite cuando el usuario hace clic en un enlace incluido en el texto. El enlace debe estar en formato de texto enriquecido o HTML, y la cadena « link » permite acceder a ese enlace concreto.
Text {
textFormat: Text.RichText
text: "See the <a href=\"http://qt-project.org\">Qt Project website</a>."
onLinkActivated: (link)=> console.log(link + " link activated")
}El código de ejemplo mostrará el texto «Visita la página web del proyecto Qt».
Al hacer clic en el enlace resaltado, se mostrará http://qt-project.org link activated en la consola.
Nota: El controlador correspondiente es onLinkActivated.
linkHovered(string link)
Esta señal se emite cuando el usuario pasa el cursor por encima de un enlace incrustado en el texto. El enlace debe estar en formato de texto enriquecido o HTML, y la cadena « link » permite acceder a ese enlace concreto.
Nota: El controlador correspondiente es onLinkHovered.
Véase también hoveredLink y linkAt().
Documentación del método
void forceLayout()
Provoca un reajuste de la disposición del texto mostrado.
string linkAt(real x, real y)
Devuelve la cadena del enlace en el punto x, y en coordenadas de contenido, o una cadena vacía si no existe ningún enlace en ese punto.
Véase también hoveredLink.
© 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.
