Qt3DRender::QSubtreeEnabler Class
class Qt3DRender::QSubtreeEnabler启用或禁用帧图节点的整个子树。更多
| 头文件： | #include <QSubtreeEnabler> |
| 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) |
详细说明
虽然 QFrameGraphNodes 可以通过enabled 属性单独启用或禁用，但当需要打开或关闭整个路径时，这可能会变得繁琐。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) |
Notifier 信号：
| void | enablementChanged(Qt3DRender::QSubtreeEnabler::Enablement enablement) |
成员函数文档
[invokable] void QSubtreeEnabler::requestUpdate()
请求启用子树。
这是一个方便的方法，用于SingleShot enablement。
注： 可通过元对象系统和 QML 调用此函数。请参阅Q_INVOKABLE 。
© 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.
