Класс QDBusPendingCall

Класс QDBusPendingCall относится к одному ожидающему асинхронному вызову. Подробнее...

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

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

Статические открытые члены

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

Объект QDBusPendingCall представляет собой ссылку на вызов метода, отправленный по D-Bus без ожидания ответа. QDBusPendingCall — это непрозрачный тип, предназначенный для использования в качестве маркера для ожидающего ответа.

В большинстве программ класс QDBusPendingCall не используется напрямую. Его можно безопасно заменить шаблонным классом QDBusPendingReply, чтобы получить доступ к содержимому ответа или дождаться его завершения.

Класс QDBusPendingCallWatcher позволяет подключиться к сигналу, который укажет, когда ответ получен или вызов истек по времени. Он также предоставляет метод QDBusPendingCallWatcher::waitForFinished(), который приостановит выполнение программы до получения ответа.

Примечание: Если вы создадите копию объекта QDBusPendingCall, вся информация будет разделена между многими копиями. Следовательно, QDBusPendingCall — это объект с явным совместным использованием, и он не предоставляет метод отсоединения копий (поскольку они ссылаются на один и тот же ожидающий вызов).

См. также QDBusPendingReply и QDBusPendingCallWatcher.

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

QDBusPendingCall::QDBusPendingCall(const QDBusPendingCall &other)

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

QDBusPendingCall &QDBusPendingCall::operator=(const QDBusPendingCall &other)

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

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

QDBusPendingCall::~QDBusPendingCall()

Уничтожает эту копию объекта QDBusPendingCall. Если эта копия также является последней копией ожидающего асинхронного вызова, вызов будет отменён, и дальнейшие уведомления не будут получены. Не будет возможности получить доступ к содержимому ответа при его поступлении.

[static] QDBusPendingCall QDBusPendingCall::fromCompletedCall(const QDBusMessage &msg)

Создаёт объект QDBusPendingCall на основе сообщения msg. Сообщение должно быть типа QDBusMessage::ErrorMessage или QDBusMessage::ReplyMessage (то есть сообщение, типичное для завершённого вызова).

Эта функция полезна для кода, требующего моделирования ожидающего вызова, но уже завершённого.

См. также fromError().

[static] QDBusPendingCall QDBusPendingCall::fromError(const QDBusError &error)

Создаёт объект QDBusPendingCall на основе условия ошибки error. Результирующий объект ожидающего вызова будет в состоянии «завершён» и QDBusPendingReply<Types...>::isError() вернёт true.

См. также fromCompletedCall().

[since 5.0] void QDBusPendingCall::swap(QDBusPendingCall &other)

Меняет местами этот экземпляр ожидающего вызова с other. Эта функция очень быстрая и никогда не терпит неудачу.

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