Sur cette page

Qt3DRender::QSubtreeEnabler Class

class Qt3DRender::QSubtreeEnabler

Active ou désactive des sous-arbres entiers de nœuds du graphe. Plus d'informations...

En-tête : #include <QSubtreeEnabler>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake : QT += 3drender
En QML : SubtreeEnabler
Hérite : Qt3DRender::QFrameGraphNode
Statut : Déclassé

Types publics

enum Enablement { Persistent, SingleShot }

Propriétés

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 QFrameGraphNodes puissent être activés et désactivés individuellement via la propriété enabled, cela peut devenir fastidieux lorsqu'un chemin entier doit être activé ou désactivé. QSubtreeEnabler est un nœud de commodité qui rend ce cas d'utilisation trivial, permettant à tous ses enfants d'être contrôlés par un seul interrupteur.

QSubtreeEnabler est activé par défaut.

Documentation des types de membres

enum QSubtreeEnabler::Enablement

Spécifie si l'activation des sous-arbres est persistante ou transitoire.

ConstanteValeurDescription
Qt3DRender::QSubtreeEnabler::Persistent0La valeur de enabled est persistante. Il s'agit de la valeur par défaut.
Qt3DRender::QSubtreeEnabler::SingleShot1La valeur de enabled dure une seule image et est ensuite réinitialisée à false. Ceci peut être utilisé pour un sous-arbre dessinant un FBO, par exemple, afin de ne mettre à jour le FBO que lorsque les parties concernées de la scène ont changé.

Documentation sur les propriétés

enablement : Enablement

Contrôle si l'activation des sous-arbres est persistante ou transitoire.

Fonctions d'accès :

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

Signal du notificateur :

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

Fonction membre Documentation

[invokable] void QSubtreeEnabler::requestUpdate()

Demande que la sous-arborescence soit activée.

Méthode de commodité destinée à être utilisée avec SingleShot enablement.

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de 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.