En esta página

QDBusPendingCall Class

La clase QDBusPendingCall hace referencia a una llamada asíncrona pendiente. Más información...

Encabezado: #include <QDBusPendingCall>
CMake: find_package(Qt6 REQUIRED COMPONENTS DBus)
target_link_libraries(mytarget PRIVATE Qt6::DBus)
qmake: QT += dbus
Heredado por:

QDBusPendingCallWatcher

Funciones públicas

QDBusPendingCall(const QDBusPendingCall &other)
(since 6.10) QDBusPendingCall(QDBusPendingCall &&other)
~QDBusPendingCall()
void swap(QDBusPendingCall &other)
QDBusPendingCall &operator=(QDBusPendingCall &&other)
QDBusPendingCall &operator=(const QDBusPendingCall &other)

Miembros públicos estáticos

QDBusPendingCall fromCompletedCall(const QDBusMessage &msg)
QDBusPendingCall fromError(const QDBusError &error)

Descripción detallada

Un objeto QDBusPendingCall es una referencia a una llamada a un método que se envió a través de D-Bus sin esperar una respuesta. QDBusPendingCall es un tipo opaco, destinado a utilizarse como identificador de una respuesta pendiente.

En la mayoría de los programas, la clase QDBusPendingCall no se utilizará directamente. Se puede sustituir sin problema por la clase basada en plantillas QDBusPendingReply, con el fin de acceder al contenido de la respuesta o esperar a que se complete.

La clase ` QDBusPendingCallWatcher ` permite conectarse a una señal que indicará cuándo ha llegado la respuesta o si la llamada ha agotado el tiempo de espera. También proporciona el método ` QDBusPendingCallWatcher::waitForFinished()`, que suspenderá la ejecución del programa hasta que llegue la respuesta.

Nota: Si se crea una copia de un objeto `QDBusPendingCall`, toda la información se compartirá entre las distintas copias. Por lo tanto, `QDBusPendingCall` es un objeto de uso compartido explícito y no proporciona ningún método para desvincular las copias (ya que todas hacen referencia a la misma llamada pendiente).

Véase también QDBusPendingReply y QDBusPendingCallWatcher.

Documentación de las funciones de miembro

QDBusPendingCall::QDBusPendingCall(const QDBusPendingCall &other)

Crea una copia de la llamada asíncrona pendiente de other. Ten en cuenta que ambos objetos harán referencia a la misma llamada pendiente.

[constexpr noexcept default, since 6.10] QDBusPendingCall::QDBusPendingCall(QDBusPendingCall &&other)

Traslada other a este objeto.

Nota: El objeto del que se ha realizado la transferencia, other, queda en un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

Esta función se introdujo en Qt 6.10.

[noexcept] QDBusPendingCall::~QDBusPendingCall()

Destruye esta copia del objeto ` QDBusPendingCall `. Si esta copia es también la última copia de una llamada asíncrona pendiente, la llamada se cancelará y no se recibirán más notificaciones. No habrá forma de acceder al contenido de la respuesta cuando llegue.

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

Crea un objeto ` QDBusPendingCall ` a partir del mensaje ` msg`. El mensaje debe ser de tipo ` QDBusMessage::ErrorMessage ` o ` QDBusMessage::ReplyMessage ` (es decir, un mensaje típico de una llamada finalizada).

Esta función resulta útil para código que requiere simular una llamada pendiente, pero que ya ha finalizado.

Véase también fromError().

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

Crea un objeto ` QDBusPendingCall ` basado en la condición de error ` error`. El objeto de llamada pendiente resultante estará en el estado «finished» y ` QDBusPendingReply<Types...>::isError()` devolverá «true».

Véase también fromCompletedCall().

[noexcept] void QDBusPendingCall::swap(QDBusPendingCall &other)

Sustituye esta instancia de llamada pendiente por other. Esta operación es muy rápida y nunca falla.

[noexcept] QDBusPendingCall &QDBusPendingCall::operator=(QDBusPendingCall &&other)

La operación «move-assign» asigna other a este QDBusPendingCall.

Nota: El objeto del que se ha realizado el movimiento, other, pasa a un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

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

Crea una copia de la llamada asíncrona pendiente other y elimina la referencia a la llamada a la que se hacía referencia anteriormente. Ten en cuenta que, tras la ejecución de esta función, ambos objetos harán referencia a la misma llamada pendiente.

Si este objeto contenía la última referencia a una llamada asíncrona pendiente, la llamada se cancelará y no se recibirán más notificaciones. No habrá forma de acceder al contenido de la respuesta cuando llegue.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.