QSubtreeEnabler类

class Qt3DRender::QSubtreeEnabler

启用或禁用帧图节点的整个子树。更多信息...

头文件	#include <QSubtreeEnabler>
CMake	find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake	QT += 3drender
实例化自	SubtreeEnabler
继承	Qt3DRender::QFrameGraphNode

公共类型

枚举	Enablement { Persistent, SingleShot }

Qt3DRender::QSubtreeEnabler::Enablement	enablement() const
void	requestUpdate()
void	setEnablement(Qt3DRender::QSubtreeEnabler::Enablement enablement)

void	enablementChanged(Qt3DRender::QSubtreeEnabler::Enablement enablement)

虽然可以通过 enabled 属性单独启用和禁用QFrameGraphNodes，但如果整个路径需要开启或关闭，这可能变得繁琐。QSubtreeEnabler是一个方便的节点，使得这种情况变得简单，允许通过一个开关控制其所有子节点。

默认情况下，QSubtreeEnabler被启用。

指定子树启用是持久的还是瞬时的。

常量	值	描述
`Qt3DRender::QSubtreeEnabler::Persistent`	`0`	启用值的持久性。这是默认值。
`Qt3DRender::QSubtreeEnabler::SingleShot`	`1`	启用值将持续一个帧然后重置为false。这可能用于将子树绘制到FBO，例如，只有在场景的相关部分更改时才更新FBO。

控制子树启用是持久的还是瞬时的。

访问函数

Qt3DRender::QSubtreeEnabler::Enablement	enablement() const
void	setEnablement(Qt3DRender::QSubtreeEnabler::Enablement enablement)

通知信号

void	enablementChanged(Qt3DRender::QSubtreeEnabler::Enablement enablement)

请求启用子树。

一个方便的方法，用于与SingleShot启用一起使用。

注意：此功能可以通过元对象系统和从QML调用。请参阅Q_INVOKABLE。