Класс QDBusPendingCall

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

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

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

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

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

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

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

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

См. также 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.