En esta página

QSGTextNode Class

La clase QSGTextNode sirve para dibujar diseños de texto y documentos de texto en el grafo de escena de « Qt Quick ». Más información...

Encabezado: #include <QSGTextNode>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
Desde: Qt 6.7
Heredado de: QSGTransformNode

Tipos públicos

enum RenderType { QtRendering, NativeRendering, CurveRendering }
enum TextStyle { Normal, Outline, Raised, Sunken }

Funciones públicas

void addTextDocument(QPointF position, QTextDocument *document, int selectionStart = -1, int selectionCount = -1)
void addTextLayout(QPointF position, QTextLayout *layout, int selectionStart = -1, int selectionCount = -1, int lineStart = 0, int lineCount = -1)
virtual void clear() = 0
virtual QColor color() const = 0
virtual QSGTexture::Filtering filtering() const = 0
virtual QColor linkColor() const = 0
virtual QSGTextNode::RenderType renderType() const = 0
virtual int renderTypeQuality() const = 0
virtual QColor selectionColor() const = 0
virtual QColor selectionTextColor() const = 0
virtual void setColor(QColor color) = 0
virtual void setFiltering(QSGTexture::Filtering filtering) = 0
virtual void setLinkColor(QColor linkColor) = 0
virtual void setRenderType(QSGTextNode::RenderType renderType) = 0
virtual void setRenderTypeQuality(int renderTypeQuality) = 0
virtual void setSelectionColor(QColor color) = 0
virtual void setSelectionTextColor(QColor selectionTextColor) = 0
virtual void setStyleColor(QColor styleColor) = 0
virtual void setTextStyle(QSGTextNode::TextStyle textStyle) = 0
virtual void setViewport(const QRectF &viewport) = 0
virtual QColor styleColor() const = 0
virtual QSGTextNode::TextStyle textStyle() = 0
virtual QRectF viewport() const = 0

Funciones privadas

virtual void doAddTextDocument(QPointF position, QTextDocument *document, int selectionStart, int selectionCount) = 0
virtual void doAddTextLayout(QPointF position, QTextLayout *layout, int selectionStart, int selectionCount, int lineStart, int lineCount) = 0

Descripción detallada

QSGTextNode puede resultar útil para crear elementos personalizados de « Qt Quick » que requieran texto. Se utiliza en Qt Quick mediante los elementos Text, TextEdit y TextInput.

Se pueden crear objetos QSGTextNode mediante QQuickWindow::createTextNode(). Las funciones addTextLayout() y addTextDocument() permiten añadir texto al QSGTextNode. El texto debe estar ya maquetado.

Nota: Para que surtan efecto,las propiedades deben establecerse antes de llamar a addTextLayout() o addTextDocument().

Nota: La destrucción del QSGTextNode debe gestionarse con cuidado. En particular, dado que hace referencia a recursos gráficos, debe eliminarse cuando se invalide el grafo de escena Qt Quick. Si el nodo forma parte del grafo y tiene activado el indicador OwnedByParent (que es el valor por defecto), esto ocurrirá automáticamente. Sin embargo, si el indicador « OwnedByParent » está desactivado y el nodo se elimina manualmente, hay que asegurarse de hacerlo cuando se invalide el grafo de escena. Esto puede hacerse conectándose a la señal « QQuickWindow::sceneGraphInvalidated()», o implementando una ranura en la subclase de « QQuickItem » denominada « invalidateSceneGraph() ». Véase también la documentación de « QQuickItem » para obtener más detalles.

Documentación sobre los tipos de miembros

enum QSGTextNode::RenderType

Este tipo de enumeración describe el tipo de nodo de glifo utilizado para representar el texto.

ConstanteValorDescripción
QSGTextNode::QtRendering0El texto se representa utilizando un campo de distancia escalable para cada glifo.
QSGTextNode::NativeRendering1El texto se representa utilizando una técnica específica de la plataforma.
QSGTextNode::CurveRendering2El texto se representa mediante un rasterizador de curvas que se ejecuta directamente en el hardware gráfico.

Selecciona « 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 baja 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. « CurveRendering » debe considerarse como alternativa en los casos en que « QtRendering » no ofrezca buenos resultados visuales o cuando sea prioritario reducir el consumo de memoria gráfica.

Véase también setRenderType() y setRenderTypeQuality().

enum QSGTextNode::TextStyle

Este tipo de enumeración describe los estilos que se pueden aplicar a la representación del texto.

ConstanteValorDescripción
QSGTextNode::Normal0El texto se dibuja sin aplicar ningún estilo.
QSGTextNode::Outline1El texto se dibuja con un contorno.
QSGTextNode::Raised2El texto se dibuja en relieve.
QSGTextNode::Sunken3El texto se dibuja en relieve negativo.

Véase también setTextStyle() y setStyleColor().

Documentación de funciones de miembro

void QSGTextNode::addTextDocument(QPointF position, QTextDocument *document, int selectionStart = -1, int selectionCount = -1)

Añade el contenido de document al nodo de texto situado en position. Si selectionStart es >= 0, esto marca el primer carácter de un área seleccionada de selectionCount número de caracteres. La selección se representa como un relleno de fondo con la función selectionColor() y el texto seleccionado se representa con la función selectionTextColor().

Esta función reenvía sus argumentos a la función virtual doAddTextDocument().

Véase también clear().

void QSGTextNode::addTextLayout(QPointF position, QTextLayout *layout, int selectionStart = -1, int selectionCount = -1, int lineStart = 0, int lineCount = -1)

Añade el contenido de layout al nodo de texto situado en position. Si selectionStart es >= 0, esto marca el primer carácter de un área seleccionada de selectionCount número de caracteres. La selección se representa como un relleno de fondo con la función selectionColor() y el texto seleccionado se muestra con la función selectionTextColor().

Para mayor comodidad, se pueden utilizar ` lineStart ` y ` lineCount ` para seleccionar el rango de objetos ` QTextLine ` que se incluirán en el diseño. Esto puede resultar útil, por ejemplo, al crear diseños elididos. Si ` lineCount ` es < 0, el nodo incluirá las líneas desde ` lineStart ` hasta el final del diseño.

Esta función reenvía sus argumentos a la función virtual doAddTextLayout().

Véase también clear().

[pure virtual] void QSGTextNode::clear()

Borra el contenido del nodo, eliminando los nodos y demás datos que representan los diseños y documentos que se le han añadido.

Véase también addTextLayout() y addTextDocument().

[pure virtual] QColor QSGTextNode::color() const

Devuelve el color principal utilizado al mostrar el texto.

Véase también setColor().

[pure virtual private] void QSGTextNode::doAddTextDocument(QPointF position, QTextDocument *document, int selectionStart, int selectionCount)

Función virtual llamada por ` addTextDocument()`, que convierte el contenido de ` document ` en nodos del grafo de escena y los añade al nodo actual en ` position`.

Si selectionStart es >= 0, esto marca el primer carácter de un área seleccionada de selectionCount número de caracteres. La selección se representa como un relleno de fondo con selectionColor() y el texto seleccionado se representa en selectionTextColor().

Véase también clear() y addTextDocument().

[pure virtual private] void QSGTextNode::doAddTextLayout(QPointF position, QTextLayout *layout, int selectionStart, int selectionCount, int lineStart, int lineCount)

Función virtual llamada por ` addTextLayout()`, que convierte el contenido de ` layout ` en nodos del grafo de escena y los añade al nodo actual en ` position`.

Si selectionStart es >= 0, esto marca el primer carácter de un área seleccionada de selectionCount número de caracteres. La selección se representa como un relleno de fondo con selectionColor() y el texto seleccionado se representa en selectionTextColor().

Para mayor comodidad, se pueden utilizar « lineStart » y « lineCount » para seleccionar el rango de objetos « QTextLine » que se incluirán en el diseño. Esto puede resultar útil, por ejemplo, al crear diseños elididos. Si « lineCount » es < 0, el nodo incluirá las líneas desde « lineStart » hasta el final del diseño.

Véase también clear() y addTextLayout().

[pure virtual] QSGTexture::Filtering QSGTextNode::filtering() const

Devuelve el modo de muestreo utilizado al redimensionar las imágenes que forman parte del texto mostrado.

Véase también setFiltering().

[pure virtual] QColor QSGTextNode::linkColor() const

Devuelve el color de los hipervínculos del texto.

Véase también setLinkColor().

[pure virtual] QSGTextNode::RenderType QSGTextNode::renderType() const

Devuelve el tipo de nodo de glifo utilizado para representar el texto.

Véase también setRenderType().

[pure virtual] int QSGTextNode::renderTypeQuality() const

Devuelve la calidad del tipo de representación del nodo. Consulta setRenderTypeQuality() para obtener más detalles.

Véase también setRenderTypeQuality().

[pure virtual] QColor QSGTextNode::selectionColor() const

Devuelve el color del fondo de la selección cuando se marca como seleccionado cualquier parte del texto.

Véase también setSelectionColor().

[pure virtual] QColor QSGTextNode::selectionTextColor() const

Devuelve el color del texto seleccionado cuando se marca como seleccionado cualquier parte del texto.

Véase también setSelectionTextColor().

[pure virtual] void QSGTextNode::setColor(QColor color)

Establece el color principal que se utilizará al renderizar el texto en color.

El valor predeterminado es el negro: QColor(0, 0, 0).

Véase también color().

[pure virtual] void QSGTextNode::setFiltering(QSGTexture::Filtering filtering)

Establece el modo de muestreo utilizado al escalar las imágenes que forman parte del texto mostrado en « filtering ». Para obtener imágenes escaladas con suavidad, utiliza aquí « QSGTexture::Linear ».

El valor por defecto es « QSGTexture::Nearest ».

Véase también filtering().

[pure virtual] void QSGTextNode::setLinkColor(QColor linkColor)

Establece el color de los hipervínculos a linkColor que aparecen en el texto.

El valor predeterminado es el azul: QColor(0, 0, 255).

Véase también linkColor().

[pure virtual] void QSGTextNode::setRenderType(QSGTextNode::RenderType renderType)

Establece el tipo de nodo de glifo en uso como « renderType ».

El valor por defecto es ` QtRendering`.

Véase también ` renderType()`.

[pure virtual] void QSGTextNode::setRenderTypeQuality(int renderTypeQuality)

Si el objeto ` renderType()` que se está utilizando lo admite, establece la calidad que se utilizará al renderizar el texto. Cuando sea compatible, esto se puede utilizar para sacrificar la fidelidad visual a cambio de velocidad de ejecución o memoria.

Cuando el valor de renderTypeQuality es < 0, se utiliza la calidad predeterminada.

renderTypeQuality puede ser cualquier número entero, aunque pueden surgir limitaciones impuestas por el hardware gráfico subyacente si se establecen valores extremos. El elemento de texto « Qt Quick » funciona con los siguientes valores predefinidos:

ConstanteDescripción
DefaultRenderTypeQuality-1 (por defecto)
LowRenderTypeQuality26
NormalRenderTypeQuality52
HighRenderTypeQuality104
VeryHighRenderTypeQuality208

Actualmente, este valor solo se tiene en cuenta en el tipo de representación « QtRendering ». Al configurarlo, se modifica la resolución de los campos de distancia utilizados para representar los glifos. Si se establece un valor superior al normal, aumentará el consumo de memoria, pero se reducirán los artefactos de filtrado en textos muy extensos.

El valor por defecto es -1.

Véase también renderTypeQuality().

[pure virtual] void QSGTextNode::setSelectionColor(QColor color)

Establece el color del fondo de la selección en color cuando se marca como seleccionado cualquier parte del texto.

El valor predeterminado es azul oscuro: QColor(0, 0, 128).

Véase también selectionColor().

[pure virtual] void QSGTextNode::setSelectionTextColor(QColor selectionTextColor)

Establece el color del texto seleccionado en selectionTextColor cuando se marca como seleccionado cualquier parte del texto.

El valor predeterminado es blanco: QColor(255, 255, 255).

Véase también selectionTextColor().

[pure virtual] void QSGTextNode::setStyleColor(QColor styleColor)

Establece el color del estilo que se utilizará al representar el texto en styleColor.

El valor predeterminado es el negro: QColor(0, 0, 0).

Véase también styleColor() y setTextStyle().

[pure virtual] void QSGTextNode::setTextStyle(QSGTextNode::TextStyle textStyle)

Establece el estilo del texto renderizado en « textStyle ». El valor por defecto es « Normal ».

Véanse también textStyle() y setStyleColor().

[pure virtual] void QSGTextNode::setViewport(const QRectF &viewport)

Establece el rectángulo delimitador de la ventana gráfica en la que se muestra el texto como ` viewport`. Al proporcionar esta información, se permite que el ` QSGTextNode ` optimice qué partes del diseño del texto o del documento se incluyen en el grafo de escena.

El valor por defecto es un objeto ` QRectF` creado de forma predeterminada. Para esta ventana gráfica, se incluirá todo el contenido en el grafo.

Véase también viewport().

[pure virtual] QColor QSGTextNode::styleColor() const

Devuelve el color del estilo utilizado al representar el texto.

Véase también setStyleColor() y textStyle().

[pure virtual] QSGTextNode::TextStyle QSGTextNode::textStyle()

Devuelve el estilo del texto representado.

Véase también setTextStyle() y styleColor().

[pure virtual] QRectF QSGTextNode::viewport() const

Devuelve la ventana de visualización actual configurada para este QSGTextNode.

Véase también setViewport().

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