QNode类

class Qt3DCore::QNode

QNode是所有Qt3D节点类的基类，用于构建Qt3D场景。更多...

头文件 #include <QNode>
CMakefind_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmakeQT += 3dcore
继承 QObject
继承自
32种类型

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, 以及 Qt3DRender::Quick::QScene2D

属性

公共函数

QNode(Qt3DCore::QNode *parent = nullptr)
boolblockNotifications(bool block)
Qt3DCore::QNodeVectorchildNodes() const
Qt3DCore::QNodeIdid() const
boolisEnabled() const
boolnotificationsBlocked() const
Qt3DCore::QNode *parentNode() const

公共槽

voidsetEnabled(bool isEnabled)
voidsetParent(Qt3DCore::QNode *parent)

信号

voidenabledChanged(bool enabled)
voidnodeDestroyed()
voidparentChanged(QObject *parent)
QNodePtr
QNodeVector
Qt3DCore::QNodeIdqIdForNode(Qt3DCore::QNode *node)
Qt3DCore::QNodeIdVectorqIdsForNodes(const T &nodes)

详细描述

QNode的所有权由节点之间的QObject父子关系决定。本身，QNode没有可视外观，也没有特殊含义，它只是一个基于节点构建树结构的方式。

QNode实例的父节点只能是另一个QNode实例。

每个QNode实例都有一个唯一的ID，使其可以从其他实例中识别。

当在QNode子类上定义属性时，它们的NOTIFY信号将自动生成Qt3D后端方面将接收的通知。

另请参阅QEntity和QComponent。

属性文档

enabled : bool

包含QNode启用标志。默认情况下，QNode总是启用的。

注意： 对“启用”含义的解释是方面相关的。即使将启用设置为false，某些方面仍可能以某种方式考虑节点。这将在每个类中分别记录。

访问函数

boolisEnabled() const
voidsetEnabled(bool isEnabled)

通知器信号

voidenabledChanged(bool enabled)

parent : Qt3DCore::QNode*

包含直接QNode父节点，如果没有父节点则为null。

设置父节点将通知后端方面关于当前QNode实例父节点更改的情况。

注意： 如果parent是null，实际上这将通知当前QNode实例已从场景中删除。

访问函数

Qt3DCore::QNode *parentNode() const
voidsetParent(Qt3DCore::QNode *parent)

通知器信号

voidparentChanged(QObject *parent)

成员函数文档

[显式] QNode::QNode(Qt3DCore::QNode *parent = nullptr)

使用父节点parent创建新的QNode实例。

注意： 只有当QNode实例有父节点时，后端方面才会通知QNode实例是场景的一部分；除非这是Qt3D场景的根节点。

另请参阅setParent。

bool QNode::blockNotifications(bool block)

如果block是true，则此对象向方面发送的属性更改通知被阻止。如果block是false，则不会发生此类阻止。

返回值是notificationsBlocked的先前值。

请注意，即使此对象的提醒已被阻止，其他提醒类型仍将被发送。

也见 notificationsBlocked()。

Qt3DCore::QNodeVector QNode::childNodes() const

返回一个填充着当前 QNode 实例的 QNode 子节点的列表。

Qt3DCore::QNodeId QNode::id() const

返回唯一标识 QNode 实例的 id。

[信号] void QNode::nodeDestroyed()

节点被销毁时发出。

bool QNode::notificationsBlocked() const

如果阻塞了方面提醒，则返回 true；否则返回 false。默认情况下，提醒不会被阻塞。

也见 blockNotifications()。

相关非成员

[别名] QNodePtr

对 QNode 的共享指针。

[别名] QNodeVector

QNode 指针的列表。

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

返回 node 的节点 id。

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

返回 nodes 的节点 id 向量。

© 2024 The Qt Company Ltd. 即此包含的文档贡献是各自所有者的版权。本提供的文档是根据由自由软件基金会发布的 GNU 自由文档许可证版本 1.3 的条款授权的。Qt 和相应的标志是 The Qt Company Ltd 在芬兰和其他国家和地区注册的商标。所有其他商标均为各自所有者的财产。