Класс 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 или до тех пор, пока не закончатся объекты для инкубации.

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 — новое количество инкубируемых объектов.

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