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) |
詳細な説明
QFrameGraphNodesはenabled プロパティを通じて個別に有効化・無効化できますが、パス全体をオンまたはオフにする必要がある場合、この操作は煩雑になりがちです。QSubtreeEnablerは、このユースケースを極めて簡単にする便利なノードであり、1つのスイッチですべての子ノードを制御できるようにします。
QSubtreeEnablerはデフォルトで有効になっています。
メンバ型のドキュメント
enum QSubtreeEnabler::Enablement
サブツリーの有効化が永続的か一時的かを指定します。
| 定数 | 値 | 説明 |
|---|---|---|
Qt3DRender::QSubtreeEnabler::Persistent | 0 | enabled の値は永続的です。これがデフォルトです。 |
Qt3DRender::QSubtreeEnabler::SingleShot | 1 | enabled の値は 1 フレームの間のみ有効で、その後 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.
