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.
| Constante | Valor | Descripción |
|---|---|---|
QSGTextNode::QtRendering | 0 | El texto se representa utilizando un campo de distancia escalable para cada glifo. |
QSGTextNode::NativeRendering | 1 | El texto se representa utilizando una técnica específica de la plataforma. |
QSGTextNode::CurveRendering | 2 | El 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.
| Constante | Valor | Descripción |
|---|---|---|
QSGTextNode::Normal | 0 | El texto se dibuja sin aplicar ningún estilo. |
QSGTextNode::Outline | 1 | El texto se dibuja con un contorno. |
QSGTextNode::Raised | 2 | El texto se dibuja en relieve. |
QSGTextNode::Sunken | 3 | El 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:
| Constante | Descripción |
|---|---|
DefaultRenderTypeQuality | -1 (por defecto) |
LowRenderTypeQuality | 26 |
NormalRenderTypeQuality | 52 |
HighRenderTypeQuality | 104 |
VeryHighRenderTypeQuality | 208 |
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.