QSubtreeEnabler Class

class Qt3DRender::QSubtreeEnabler

Aktiviert oder deaktiviert ganze Teilbäume von Framegraph-Knoten. Mehr...

Kopfzeile: #include <QSubtreeEnabler>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
In QML: SubtreeEnabler
Vererbt: Qt3DRender::QFrameGraphNode
Status: Veraltet

Öffentliche Typen

enum Enablement { Persistent, SingleShot }

Eigenschaften

Öffentliche Funktionen

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

Signale

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

Detaillierte Beschreibung

Während QFrameGraphNodes über die Eigenschaft enabled einzeln ein- und ausgeschaltet werden können, kann dies mühsam werden, wenn ein ganzer Pfad ein- oder ausgeschaltet werden muss. QSubtreeEnabler ist ein Komfortknoten, der diesen Anwendungsfall trivial macht, indem er es ermöglicht, alle seine Kinder mit einem einzigen Schalter zu steuern.

QSubtreeEnabler ist standardmäßig aktiviert.

Dokumentation der Mitgliedstypen

enum QSubtreeEnabler::Enablement

Gibt an, ob die Teilbaumaktivierung dauerhaft oder nur vorübergehend ist.

KonstanteWertBeschreibung
Qt3DRender::QSubtreeEnabler::Persistent0Der Wert von enabled ist persistent. Dies ist der Standardwert.
Qt3DRender::QSubtreeEnabler::SingleShot1Der Wert von enabled bleibt für einen einzigen Frame bestehen und wird dann auf false zurückgesetzt. Dies könnte z. B. für einen Teilbaum verwendet werden, der auf einen FBO gezeichnet wird, um den FBO nur zu aktualisieren, wenn sich die relevanten Teile der Szene ändern.

Dokumentation der Eigenschaft

enablement : Enablement

Steuert, ob die Teilbaumaktivierung dauerhaft oder vorübergehend ist.

Zugriffsfunktionen:

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

Benachrichtigungssignal:

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

Dokumentation der Mitgliedsfunktionen

[invokable] void QSubtreeEnabler::requestUpdate()

Fordert an, dass der Teilbaum aktiviert wird.

Eine bequeme Methode, die mit SingleShot enablement verwendet werden soll.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe 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.