Класс QQmlIncubationController

Экземпляры QQmlIncubationController управляют процессом инкубации объектов QQmlIncubators. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Защищенные функции

Подробное описание

Для асинхронного поведения и предотвращения подергиваний или зависаний приложения, процесс создания объектов QQmlIncubators должен выполняться только во время простоя приложения. QQmlIncubationController позволяет приложению точно управлять тем, когда, как часто и как долго происходит эта обработка.

Экземпляр класса, производный от QQmlIncubationController, должен быть создан и задан на QQmlEngine вызовом метода QQmlEngine::setIncubationController(). Затем обработка контролируется вызовами методов QQmlIncubationController::incubateFor() или QQmlIncubationController::incubateWhile() в соответствии с потребностями приложения.

Например, это пример контроллера инкубации, который будет инкубировать объекты максимум 5 миллисекунд каждые 16 миллисекунд.

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

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

Хотя предыдущий пример будет работать, он не оптимален. В реальных контроллерах инкубации следует пытаться максимизировать использование времени простоя — а не использовать статическую величину, например, 5 миллисекунд — не мешая работе приложения.

Документация по членам-функциям

QQmlIncubationController::QQmlIncubationController()

Создать новый контроллер инкубации.

QQmlEngine *QQmlIncubationController::engine() const

Возвращает QQmlEngine, на котором установлен этот контроллер инкубации, или 0, если он не установлен на какой-либо движок.

void QQmlIncubationController::incubateFor(int msecs)

Инкубировать объекты в течение msecs или до тех пор, пока не будет больше объектов для инкубации.

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

Инкубировать объекты, пока атомный булевский флаг, на который указывает flag, имеет значение true, или до тех пор, пока не будет больше объектов для инкубации, или в течение msecs, если msecs не равно нулю.

Обычно этот метод используется совместно с потоком или сигналом UNIX, который устанавливает булевский флаг, на который указывает flag, в false, когда необходимо прервать инкубацию.

Эта функция была добавлена в Qt 5.15.

int QQmlIncubationController::incubatingObjectCount() const

Возвращает количество объектов, которые в данный момент инкубируются.

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

Вызывается, когда меняется количество инкубируемых объектов. incubatingObjectCount — новое количество инкубируемых объектов.

Реализация по умолчанию ничего не делает.