En esta página

Qt3DCore::QNode Class

class Qt3DCore::QNode

QNode es la clase base de todas las clases de nodos de Qt3D que se utilizan para crear una escena de Qt3D. Más información...

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Propiedades

Funciones públicas

QNode(Qt3DCore::QNode *parent = nullptr)
bool blockNotifications(bool block)
Qt3DCore::QNodeVector childNodes() const
Qt3DCore::QNodeId id() const
bool isEnabled() const
bool notificationsBlocked() const
Qt3DCore::QNode *parentNode() const

Ranuras públicas

void setEnabled(bool isEnabled)
void setParent(Qt3DCore::QNode *parent)

Señales

void enabledChanged(bool enabled)
void nodeDestroyed()
void parentChanged(QObject *parent)
QNodePtr
QNodeVector
Qt3DCore::QNodeId qIdForNode(Qt3DCore::QNode *node)
Qt3DCore::QNodeIdVector qIdsForNodes(const T &nodes)

Descripción detallada

La propiedad de un QNode viene determinada por la relación padre/hijo QObject entre los nodos. Por sí mismo, un QNode no tiene apariencia visual ni significado concreto; su función es servir de base para construir una estructura de árbol basada en nodos.

El padre de una instancia de QNode solo puede ser otra instancia de QNode.

Cada instancia de QNode tiene un identificador único que permite distinguirla de otras instancias.

Cuando se definen propiedades en una subclase de QNode, su señal NOTIFY generará automáticamente notificaciones que recibirán los componentes del backend de Qt3D.

Véase también QEntity y QComponent.

Documentación de propiedades

enabled : bool

Contiene el indicador « QNode » activado. Por defecto, un « QNode » siempre está activado.

Nota: la interpretación de lo que significa «habilitado» depende del aspecto. Aunque «habilitado» esté establecido en « false », algunos aspectos pueden seguir teniendo en cuenta el nodo de alguna manera. Esto se documenta clase por clase.

Funciones de acceso:

bool isEnabled() const
void setEnabled(bool isEnabled)

Señal del notificador:

void enabledChanged(bool enabled)

parent : Qt3DCore::QNode*

Contiene el padre inmediato de QNode, o «null» si el nodo no tiene padre.

Al establecer el padre, se notificará a los aspectos del backend el cambio de padre de la instancia actual de ` QNode `.

Nota: si parent resulta ser nulo, esto notificará en realidad que la instancia actual de QNode ha sido eliminada de la escena.

Funciones de acceso:

Qt3DCore::QNode *parentNode() const
void setParent(Qt3DCore::QNode *parent)

Señal de notificador:

void parentChanged(QObject *parent)

Documentación de las funciones de miembro

[explicit] QNode::QNode(Qt3DCore::QNode *parent = nullptr)

Crea una nueva instancia de QNode cuyo padre es parent.

Nota: Los componentes del backend solo recibirán la notificación de que una instancia de QNode forma parte de la escena si tiene un padre, salvo que se trate del nodo raíz de la escena Qt3D.

Véase también setParent().

bool QNode::blockNotifications(bool block)

Si ` block ` es ` true`, se bloquean las notificaciones de cambio de propiedad enviadas por este objeto a los aspectos. Si ` block ` es ` false`, no se producirá dicho bloqueo.

El valor devuelto es el valor anterior de notificationsBlocked().

Tenga en cuenta que los demás tipos de notificación se enviarán incluso si se han bloqueado las notificaciones de este objeto.

Véase también notificationsBlocked().

Qt3DCore::QNodeVector QNode::childNodes() const

Devuelve una lista que contiene los elementos secundarios de tipo « QNode » de la instancia actual de « QNode ».

Qt3DCore::QNodeId QNode::id() const

Devuelve el identificador que identifica de forma única la instancia de ` QNode `.

[signal] void QNode::nodeDestroyed()

Se emite cuando se destruye el nodo.

bool QNode::notificationsBlocked() const

Devuelve « true » si se bloquean las notificaciones de aspectos; en caso contrario, devuelve « false ». Por defecto, las notificaciones no están bloqueadas.

Véase también blockNotifications().

Elementos no miembros relacionados

[alias] QNodePtr

Un puntero compartido para QNode.

[alias] QNodeVector

Lista de consejos de « QNode ».

Qt3DCore::QNodeId qIdForNode(Qt3DCore::QNode *node)

Devuelve el identificador del nodo de node.

template <typename T> Qt3DCore::QNodeIdVector qIdsForNodes(const T &nodes)

Devuelve un vector con los identificadores de los nodos de nodes.

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