En esta página

Qt3DRender::QSubtreeEnabler Class

class Qt3DRender::QSubtreeEnabler

Activa o desactiva subárboles completos de nodos del framegraph. Más...

Encabezado: #include <qsubtreeenabler.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
En QML: SubtreeEnabler
Heredado de: Qt3DRender::QFrameGraphNode
Estado: Obsoleta

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Tipos públicos

enum Enablement { Persistent, SingleShot }

Propiedades

Funciones públicas

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

Señales

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

Descripción detallada

Aunque los nodos QFrameGraphNodes se pueden activar y desactivar individualmente mediante la propiedad « enabled », esto puede resultar tedioso cuando es necesario activar o desactivar una ruta completa. QSubtreeEnabler es un nodo de conveniencia que simplifica enormemente este caso de uso, permitiendo controlar todos sus hijos mediante un único conmutador.

QSubtreeEnabler está habilitado de forma predeterminada.

Documentación sobre los tipos de miembros

enum QSubtreeEnabler::Enablement

Especifica si la activación de subárboles es persistente o transitoria.

ConstanteValorDescripción
Qt3DRender::QSubtreeEnabler::Persistent0El valor «enabled» es persistente. Este es el valor por defecto.
Qt3DRender::QSubtreeEnabler::SingleShot1El valor «enabled» durará un solo fotograma y, a continuación, se restablecerá a «false». Esto podría utilizarse, por ejemplo, para el dibujo de un subárbol en un FBO, con el fin de actualizar el FBO únicamente cuando cambien las partes relevantes de la escena.

Documentación de la propiedad

enablement : Enablement

Determina si la activación de los subárboles es permanente o temporal.

Funciones de acceso:

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

Señal de notificador:

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

Documentación de las funciones de miembro

[invokable] void QSubtreeEnabler::requestUpdate()

Solicita que se active el subárbol.

Un método de conveniencia diseñado para utilizarse con la habilitació SingleShot.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase 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.