Qt3DCore::QEntity Class
class Qt3DCore::QEntityQt3DCore::QEntity 是 的子类，可以聚合多个 实例，指定其行为。Qt3DCore::QNode Qt3DCore::QComponent 更多
| 头文件： | #include <QEntity> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS 3DCore)target_link_libraries(mytarget PRIVATE Qt6::3DCore) |
| qmake： | QT += 3dcore |
| 在 QML 中： | Entity |
| 继承： | Qt3DCore::QNode |
| 继承于 | Qt3DExtras::QAbstractCameraController,Qt3DExtras::QSkyboxEntity,Qt3DExtras::QText2DEntity, 和Qt3DRender::QCamera |
| 状态： | 已废弃 |
公共函数
| QEntity(Qt3DCore::QNode *parent = nullptr) | |
| void | addComponent(Qt3DCore::QComponent *comp) |
| Qt3DCore::QComponentVector | components() const |
| QList<T *> | componentsOfType() const |
| Qt3DCore::QEntity * | parentEntity() const |
| void | removeComponent(Qt3DCore::QComponent *comp) |
相关非成员
详细说明
Qt3DCore::QEntity 本身就是一个空壳。Qt3DCore::QEntity 对象的行为由其引用的Qt3DCore::QComponent 对象定义。每个 Qt3D 后端方面都能通过识别实体由哪些组件组成来解释和处理实体。一个方面可能决定只处理由单个Qt3DCore::QTransform 组件组成的实体，而另一个方面则可能专注于Qt3DInput::QMouseHandler 。
另请参阅 Qt3DCore::QComponent 和Qt3DCore::QTransform 。
成员函数文档
[explicit] QEntity::QEntity(Qt3DCore::QNode *parent = nullptr)
构造一个新的Qt3DCore::QEntity 实例，parent 为父实例。
void QEntity::addComponent(Qt3DCore::QComponent *comp)
为组件comp 添加一个新引用。
注： 如果Qt3DCore::QComponent 没有父节点，则Qt3DCore::QEntity 会将自己设置为父节点，从而获得该组件的所有权。
Qt3DCore::QComponentVector QEntity::components() const
返回实体引用的Qt3DCore::QComponent 实例列表。
template <typename T> QList<T *> QEntity::componentsOfType() const
返回添加到此实体的所有可被转换为 T 类型的组件，如果没有此类组件，则返回空向量。
Qt3DCore::QEntity *QEntity::parentEntity() const
返回此实体的父Qt3DCore::QEntity 实例。如果直接父实体不是Qt3DCore::QEntity ，该函数会向上遍历场景层次结构，直到找到父实体Qt3DCore::QEntity 。如果找不到Qt3DCore::QEntity 父实体，则返回 null。
void QEntity::removeComponent(Qt3DCore::QComponent *comp)
删除对comp 的引用。
© 2025 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.
