En esta página

QQmlIncubationController Class

Las instancias de QQmlIncubationController controlan el progreso de los QQmlIncubators. Más información...

Encabezado: #include <QQmlIncubationController>
CMake: find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)
qmake: QT += qml

Funciones públicas

QQmlIncubationController()
QQmlEngine *engine() const
void incubateFor(int msecs)
void incubateWhile(std::atomic<bool> *flag, int msecs = 0)
int incubatingObjectCount() const

Funciones protegidas

virtual void incubatingObjectCountChanged(int incubatingObjectCount)

Descripción detallada

Para garantizar un comportamiento asíncrono y evitar que la aplicación se cuelgue o se ralenticione, el proceso de creación de objetos en un `QQmlIncubator` debe realizarse únicamente durante los periodos de inactividad de la aplicación. `QQmlIncubationController` permite a la aplicación controlar con exactitud cuándo, con qué frecuencia y durante cuánto tiempo se lleva a cabo este procesamiento.

Se debe crear una instancia derivada de QQmlIncubationController y asignarla a un objeto ` QQmlEngine ` llamando al método ` QQmlEngine::setIncubationController()`. A continuación, el procesamiento se controla llamando a los métodos ` QQmlIncubationController::incubateFor()` o ` QQmlIncubationController::incubateWhile()`, según lo requieran las necesidades de la aplicación.

Por ejemplo, este es un ejemplo de un controlador de incubación que incubará durante un máximo de 5 milisegundos de cada 16 milisegundos.

class PeriodicIncubationController : public QObject,
                                     public QQmlIncubationController
{
public:
    PeriodicIncubationController() {
        startTimer(16);
    }

protected:
    void timerEvent(QTimerEvent *) override {
        incubateFor(5);
    }
};

Aunque el ejemplo funciona, está muy simplificado. Los controladores de incubación del mundo real intentan maximizar la cantidad de tiempo de inactividad que consumen sin perturbar la aplicación. Utilizar una cantidad estática de 5 milisegundos, como en el ejemplo anterior, puede tanto dejar tiempo de inactividad sin aprovechar en algunos fotogramas como perturbar la aplicación en otros.

QQuickWindow, QQuickView y QQuickWidget ofrecen un controlador de incubación precreado que distribuye la incubación a lo largo de varios fotogramas utilizando un algoritmo más inteligente. Rara vez tendrás que escribir uno propio.

Documentación de las funciones de miembro

QQmlIncubationController::QQmlIncubationController()

Crea un nuevo controlador de incubación.

QQmlEngine *QQmlIncubationController::engine() const

Devuelve el ` QQmlEngine ` en el que está configurado este controlador de incubación, o 0 si no se ha configurado en ningún motor.

void QQmlIncubationController::incubateFor(int msecs)

Incuba los objetos durante msecs, o hasta que no queden más objetos que incubar.

void QQmlIncubationController::incubateWhile(std::atomic<bool> *flag, int msecs = 0)

Incuba los objetos mientras el valor booleano atómico al que apunta ` flag ` sea verdadero, o hasta que no queden más objetos por incubar, o hasta el valor de ` msecs ` si ` msecs ` no es cero.

Por lo general, este método se utiliza junto con un hilo o una señal UNIX que establece el valor booleano al que apunta flag en falso cuando se desea interrumpir la incubación.

Nota: flag se lee utilizando el orden de memoria «acquire».

int QQmlIncubationController::incubatingObjectCount() const

Devuelve el número de objetos que se están incubando actualmente.

[virtual protected] void QQmlIncubationController::incubatingObjectCountChanged(int incubatingObjectCount)

Se invoca cuando cambia el número de objetos en incubación. ` incubatingObjectCount ` es el nuevo número de objetos en incubación.

La implementación por defecto no hace nada.

© 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.