Qt3DRender::QSubtreeEnabler Class
class Qt3DRender::QSubtreeEnabler启用或禁用整个帧图节点的子树。更多...
| 标题： | #include <qsubtreeenabler.h> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake： | QT += 3drender |
| 在 QML 中： | SubtreeEnabler |
| 继承自： | Qt3DRender::QFrameGraphNode |
| 状态： | 已弃用 |
该类已弃用。我们强烈建议不要在新代码中使用它。
公共类型
| enum | Enablement { Persistent, SingleShot } |
属性
- enablement : Enablement
公共函数
| Qt3DRender::QSubtreeEnabler::Enablement | enablement() const |
| void | requestUpdate() |
| void | setEnablement(Qt3DRender::QSubtreeEnabler::Enablement enablement) |
信号
| void | enablementChanged(Qt3DRender::QSubtreeEnabler::Enablement enablement) |
详细说明
虽然可以通过enabled 属性单独启用或禁用QFrameGraphNodes，但当需要开启或关闭整个路径时，这种操作会变得非常繁琐。QSubtreeEnabler是一个便捷节点，它使这种用例变得轻而易举，允许通过一个开关控制其所有子节点。
QSubtreeEnabler 默认处于启用状态。
成员类型文档
enum QSubtreeEnabler::Enablement
指定子树启用状态是持久性的还是暂时的。
| 常量 | 值 | 描述 |
|---|---|---|
Qt3DRender::QSubtreeEnabler::Persistent | 0 | enabled 的值是持久的。这是默认值。 |
Qt3DRender::QSubtreeEnabler::SingleShot | 1 | enabled 的值将持续一个帧，然后重置为 false。这可用于子树在 FBO 上的绘制，例如，仅在场景的相关部分发生变化时更新 FBO。 |
属性文档
enablement : Enablement
控制子树启用状态是持久性的还是暂时的。
访问函数：
| Qt3DRender::QSubtreeEnabler::Enablement | enablement() const |
| void | setEnablement(Qt3DRender::QSubtreeEnabler::Enablement enablement) |
通知信号：
| void | enablementChanged(Qt3DRender::QSubtreeEnabler::Enablement enablement) |
成员函数文档
[invokable] void QSubtreeEnabler::requestUpdate()
请求启用该子树。
这是一个旨在配合SingleShot 启用功能使用的便捷方法。
注意：此 函数可通过元对象系统以及从 QML 中调用。参见Q_INVOKABLE 。
© 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.
