Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

Qt3DCore::QNode Class

class Qt3DCore::QNode

QNode est la classe de base de toutes les classes de nœuds Qt3D utilisées pour construire une scène Qt3D. En savoir plus...

En-tête : #include <QNode>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmake : QT += 3dcore
Hérite de : QObject
Hérité par :
32 types

Qt3DAnimation::QAbstractAnimationClip, Qt3DAnimation::QAbstractClipBlendNode, Qt3DAnimation::QChannelMapper, Qt3DCore::QAbstractSkeleton, Qt3DCore::QAttribute, Qt3DCore::QBuffer, Qt3DCore::QComponent, Qt3DCore::QEntity, Qt3DCore::QGeometry, Qt3DCore::QGeometryView, Qt3DCore::QJoint, Qt3DInput::QAbstractActionInput, Qt3DInput::QAbstractAxisInput, Qt3DInput::QAbstractPhysicalDevice, Qt3DInput::QAction, Qt3DInput::QAxis, Qt3DInput::QAxisSetting, Qt3DRender::QAbstractTexture, Qt3DRender::QAbstractTextureImage, Qt3DRender::QEffect, Qt3DRender::QFilterKey, Qt3DRender::QFrameGraphNode, Qt3DRender::QParameter, Qt3DRender::QPickingSettings, Qt3DRender::QRenderPass, Qt3DRender::QRenderState, Qt3DRender::QRenderTargetOutput, Qt3DRender::QShaderImage, Qt3DRender::QShaderProgram, Qt3DRender::QShaderProgramBuilder, Qt3DRender::QTechnique, et Qt3DRender::Quick::QScene2D

Statut : Obsolète

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Fonctions publiques

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

Emplacements publics

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

Signaux

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

Description détaillée

La propriété d'un QNode est déterminée par la relation parent/enfant QObject entre les nœuds. En soi, un QNode n'a aucune apparence visuelle ni aucune signification particulière ; il sert simplement à construire une structure arborescente basée sur des nœuds.

Le parent d’une instance de QNode ne peut être qu’une autre instance de QNode.

Chaque instance de QNode possède un identifiant unique qui permet de la distinguer des autres instances.

Lorsque des propriétés sont définies sur une sous-classe de QNode, leur signal NOTIFY génère automatiquement des notifications que les composants du backend Qt3D recevront.

Voir également QEntity et QComponent.

Documentation sur les propriétés

enabled : bool

Contient l'indicateur « QNode » (activé). Par défaut, un « QNode » est toujours activé.

Remarque : l’interprétation de la signification de « activé » dépend de l’aspect. Même si « activé » est défini sur « false », certains aspects peuvent tout de même prendre en compte le nœud d’une manière ou d’une autre. Ceci est documenté au cas par cas pour chaque classe.

Fonctions d’accès :

bool isEnabled() const
void setEnabled(bool isEnabled)

Signal de notification :

void enabledChanged(bool enabled)

parent : Qt3DCore::QNode*

Contient le parent immédiat de l'QNode, ou la valeur null si le nœud n'a pas de parent.

La définition du parent informera les aspects du backend du changement de parent de l’instance actuelle d’ QNode.

Remarque : si parent est null, cela indiquera en réalité que l’instance QNode actuelle a été supprimée de la scène.

Fonctions d’accès :

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

Signal de notification :

void parentChanged(QObject *parent)

Documentation des fonctions membres

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

Crée une nouvelle instance de QNode dont le parent est parent.

Remarque : les composants du backend ne seront informés qu'une instance QNode fait partie de la scène que si celle-ci possède un parent, sauf s'il s'agit du nœud racine de la scène Qt3D.

Voir aussi setParent().

bool QNode::blockNotifications(bool block)

Si la valeur de ` block ` est ` true`, les notifications de modification de propriété envoyées par cet objet aux aspects sont bloquées. Si la valeur de ` block ` est ` false`, aucun blocage de ce type ne se produit.

La valeur renvoyée est la valeur précédente de notificationsBlocked().

Notez que les autres types de notifications seront envoyés même si les notifications pour cet objet ont été bloquées.

Voir également notificationsBlocked().

Qt3DCore::QNodeVector QNode::childNodes() const

Renvoie une liste contenant tous les enfants de type « QNode » de l'instance « QNode » actuelle.

Qt3DCore::QNodeId QNode::id() const

Renvoie l'identifiant qui identifie de manière unique l'instance de ` QNode `.

[signal] void QNode::nodeDestroyed()

Émis lorsque le nœud est détruit.

bool QNode::notificationsBlocked() const

Renvoie « true » si les notifications d'aspect sont bloquées ; sinon, renvoie « false ». Par défaut, les notifications ne sont pas bloquées.

Voir également blockNotifications().

Éléments non membres associés

[alias] QNodePtr

Un pointeur partagé pour QNode.

[alias] QNodeVector

Liste des pointeurs « QNode ».

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

Renvoie l'identifiant du nœud correspondant à node.

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

Renvoie un vecteur contenant les identifiants des nœuds pour 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.