Auf dieser Seite

Qt3DRender::QSubtreeEnabler Class

class Qt3DRender::QSubtreeEnabler

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

Überschrift: #include <qsubtreeenabler.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
In QML: SubtreeEnabler
Erbt von: Qt3DRender::QFrameGraphNode
Status: Veraltet

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Ö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)

Ausführliche Beschreibung

Zwar lassen sich QFrameGraphNodes über die Eigenschaft „ enabled “ einzeln aktivieren und deaktivieren, doch kann dies mühsam werden, wenn ein ganzer Pfad ein- oder ausgeschaltet werden soll. QSubtreeEnabler ist ein Komfortknoten, der diesen Anwendungsfall vereinfacht, indem er die Steuerung aller seiner untergeordneten Knoten über einen einzigen Schalter ermöglicht.

QSubtreeEnabler ist standardmäßig aktiviert.

Dokumentation zu den Mitgliedstypen

enum QSubtreeEnabler::Enablement

Gibt an, ob die Aktivierung von Unterbäumen dauerhaft oder vorübergehend ist.

KonstanteWertBeschreibung
Qt3DRender::QSubtreeEnabler::Persistent0Der Wert „enabled“ ist dauerhaft. Dies ist die Standardeinstellung.
Qt3DRender::QSubtreeEnabler::SingleShot1Der Wert „enabled“ bleibt für einen einzelnen Frame bestehen und wird anschließend auf „false“ zurückgesetzt. Dies kann beispielsweise beim Zeichnen eines Teilbaums in ein FBO verwendet werden, um das FBO nur dann zu aktualisieren, wenn sich die relevanten Teile der Szene geändert haben.

Eigenschaftsdokumentation

enablement : Enablement

Legt fest, ob die Aktivierung von Unterbäumen 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 Komfortmethode, die für die Verwendung mit der Aktivierung von „ SingleShot “ vorgesehen ist.

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