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.