QML-тип BackgroundJob

Предоставляет средства для пробуждения/предотвращения приостановки. Подробнее…

Строка импорта: import Nemo.KeepAlive 1.2

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

Свойства

enabled : bool
frequency : enumeration
maximumWait : int
minimumWait : int
running : bool
triggeredOnEnable : bool

Сигналы

triggered()

Методы

begin()
finished()

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

Предоставляет абстракцию для планирования задач, которые могут вывести систему из приостановленного состояния и предотвратить приостановку системы во время обработки пробуждения.

Описание свойств

enabled : bool

При изменении с false на true запускает таймер.

При изменении с true на false останавливает таймер/завершает предотвращение приостановки.

Свойство enabled по умолчанию установлено как false.

frequency : enumeration

Устанавливает желаемую частоту пробуждения и запускает таймер.

Следует обратить внимание, что пробуждения согласованы в масштабе всей системы, так что все таймеры, которые запланированы на одну и ту же частоту, запускаются одновременно. Фактически это означает, что первое пробуждение, скорее всего, произойдёт раньше, чем предполагала запрашиваемая частота.

Частота может быть одной из:

BackgroundJob.ThirtySeconds;
BackgroundJob.TwoAndHalfMinutes;
BackgroundJob.FiveMinutes;
BackgroundJob.TenMinutes;
BackgroundJob.FifteenMinutes;
BackgroundJob.ThirtyMinutes;
BackgroundJob.OneHour — по умолчанию;
BackgroundJob.TwoHours;
BackgroundJob.FourHours;
BackgroundJob.EightHours;
BackgroundJob.TenHours;
BackgroundJob.TwelveHours;
BackgroundJob.TwentyFourHours;
BackgroundJob.MaximumFrequency.

Следует обратить внимание, что определение частоты пробуждения является взаимоисключающим с использованием диапазона пробуждения.

См. также BackgroundJob::minimumWait и BackgroundJob::maximumWait.

maximumWait : int

Устанавливает желаемую максимальную задержку ожидания в секундах и запускает таймер.

См. также BackgroundJob::minimumWait и BackgroundJob::frequency.

minimumWait : int

Устанавливает желаемую минимальную задержку ожидания в секундах и запускает таймер.

См. также BackgroundJob::maximumWait и BackgroundJob::frequency.

running : bool

Возвращает истинное значение, когда таймер сработал (и устройство не может приостановить работу).

triggeredOnEnable : bool

Это свойство служит той же цели, что и triggeredOnStart в стандартных объектах QML Timer: установка для triggeredOnEnable значения true вызывает запуск сразу после включения — что может быть полезно, например, для установки начального состояния.

Свойство triggeredOnEnable по умолчанию установлено как false.

Описание сигналов

triggered()

Этот сигнал испускается, когда происходит пробуждение по таймеру, и система не может приостановиться.

Чтобы снова разрешить приостановку, приложение должно определить обработчик onTriggered и убедиться, что после обработки задач, связанных с пробуждением, выполняется одно из следующих действий:

устанавливается для свойства BackgroundJob::enabled значение false — чтобы остановить таймер;
вызывается метод BackgroundJob::finished() — чтобы запланировать следующее пробуждение.

Описание методов

begin()

Если свойство enabled имеет значение true, переключает BackgroundJob в состояние выполнения и испускает сигнал BackgroundJob::triggered().

finished()

Если свойство enabled имеет значение true, перепланируется таймер пробуждения и прекращается предотвращение приостановки.