Qt3DRender::QSubtreeEnabler Class
class Qt3DRender::QSubtreeEnablerActive ou désactive des sous-arborescences entières de nœuds du framegraph. En savoir plus...
| En-tête : | #include <qsubtreeenabler.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake : | QT += 3drender |
| En QML : | SubtreeEnabler |
| Hérite de : | Qt3DRender::QFrameGraphNode |
| Statut : | Obsolète |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Types publics
| enum | Enablement { Persistent, SingleShot } |
Propriétés
- enablement : Enablement
Fonctions publiques
| Qt3DRender::QSubtreeEnabler::Enablement | enablement() const |
| void | requestUpdate() |
| void | setEnablement(Qt3DRender::QSubtreeEnabler::Enablement enablement) |
Signaux
| void | enablementChanged(Qt3DRender::QSubtreeEnabler::Enablement enablement) |
Description détaillée
Bien que les nœuds QFrameGraphNodes puissent être activés et désactivés individuellement via la propriété « enabled », cette opération peut s'avérer fastidieuse lorsqu'il s'agit d'activer ou de désactiver un chemin entier. QSubtreeEnabler est un nœud pratique qui simplifie considérablement ce cas d'utilisation, en permettant de contrôler tous ses enfants à l'aide d'un seul commutateur.
QSubtreeEnabler est activé par défaut.
Documentation sur les types de membres
enum QSubtreeEnabler::Enablement
Indique si l'activation des sous-arborescences est permanente ou temporaire.
| Constante | Valeur | Description |
|---|---|---|
Qt3DRender::QSubtreeEnabler::Persistent | 0 | La valeur « enabled » est persistante. Il s'agit de la valeur par défaut. |
Qt3DRender::QSubtreeEnabler::SingleShot | 1 | La valeur « enabled » ne dure qu’une seule trame, puis est réinitialisée à « false ». Cela peut être utilisé, par exemple, pour le dessin d’une sous-arborescence dans un FBO, afin de ne mettre à jour le FBO que lorsque les parties concernées de la scène ont changé. |
Documentation de la propriété
enablement : Enablement
Détermine si l'activation des sous-arborescences est permanente ou temporaire.
Fonctions d’accès :
| Qt3DRender::QSubtreeEnabler::Enablement | enablement() const |
| void | setEnablement(Qt3DRender::QSubtreeEnabler::Enablement enablement) |
Signal de notification :
| void | enablementChanged(Qt3DRender::QSubtreeEnabler::Enablement enablement) |
Documentation des fonctions membres
[invokable] void QSubtreeEnabler::requestUpdate()
Demande l'activation de la sous-arborescence.
Méthode pratique destinée à être utilisée avec l'activation d'SingleShot.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir 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.
