Класс 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)

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

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

Примечание: чтение flag выполняется с использованием приобретающей упорядоченности памяти.

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

int QQmlIncubationController::incubatingObjectCount() const

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

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

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

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