Qt3DCore::QComponent Class
class Qt3DCore::QComponent可由Qt3DCore::QEntity 实例作为组件进行聚合的场景节点的基类。更多内容...
| 头文件： | #include <QComponent> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS 3DCore) target_link_libraries(mytarget PRIVATE Qt6::3DCore) |
| qmake： | QT += 3dcore |
| 在 QML 中： | Component3D |
| 继承自： | Qt3DCore::QNode |
| 被继承自： | 24 种类型Qt3DAnimation::QAbstractClipAnimator、Qt3DCore::QArmature 、Qt3DCore::QBoundingVolume 、Qt3DCore::QCoreSettings 、Qt3DCore::QTransform 、Qt3DInput::QAxisAccumulator 、Qt3DInput::QInputSettings 、Qt3DInput::QKeyboardHandler 、Qt3DInput::QLogicalDevice 、Qt3DInput::QMouseHandler 、Qt3DLogic::QFrameAction 、Qt3DRender::QAbstractLight 、Qt3DRender::QAbstractRayCaster 、Qt3DRender::QCameraLens 、Qt3DRender::QComputeCommand 、Qt3DRender::QEnvironmentLight 、Qt3DRender::QLayer 、Qt3DRender::QLevelOfDetail 、Qt3DRender::QMaterial 、Qt3DRender::QObjectPicker 、Qt3DRender::QRenderSettings 、Qt3DRender::QRenderTarget 、Qt3DRender::QSceneLoader ，以及Qt3DRender::QShaderData |
| 状态： | 已弃用 |
该类已弃用。我们强烈建议不要在新的代码中使用它。
属性
- isShareable : bool
公共函数
| QComponent(Qt3DCore::QNode *parent = nullptr) | |
| QList<Qt3DCore::QEntity *> | entities() const |
| bool | isShareable() const |
公共槽位
| void | setShareable(bool isShareable) |
信号
| void | addedToEntity(Qt3DCore::QEntity *entity) |
| void | removedFromEntity(Qt3DCore::QEntity *entity) |
| void | shareableChanged(bool isShareable) |
详细说明
Qt3DCore::QComponent 提供了一种行为的垂直切片，该切片可被分配给Qt3DCore::QEntity 实例，有时也可在这些实例之间共享。
Qt3DCore::QComponent 子类通常被聚合为组，从而为聚合实体赋予有用的行为。例如，要使一个实体能够被 Qt3D 渲染器方面绘制，该实体很可能聚合Qt3DCore::QTransform 、Qt3DRender::QMesh 和Qt3DRender::QMaterial 组件。
另请参阅 Qt3DCore::QEntity 。
属性文档
isShareable : bool
保存QComponent 的可共享标志。如果true ，则QComponent 可在多个实体之间共享。
访问函数：
| bool | isShareable() const |
| void | setShareable(bool isShareable) |
通知器信号：
| void | shareableChanged(bool isShareable) |
成员函数文档
[explicit] QComponent::QComponent(Qt3DCore::QNode *parent = nullptr)
创建一个以parent 为父组件的新QComponent实例。
注意： 切勿直接实例化QComponent ，而应实例化其 子类之一。
[signal] void QComponent::addedToEntity(Qt3DCore::QEntity *entity)
表示已向entity 添加了一个引用。
QList<Qt3DCore::QEntity *> QComponent::entities() const
返回一个QList ，其中包含所有引用此组件的实体。
[signal] void QComponent::removedFromEntity(Qt3DCore::QEntity *entity)
表示已从entity 中移除了该引用。
© 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.
