QDBusPendingCall Class
La classe `QDBusPendingCall` fait référence à un appel asynchrone en attente. En savoir plus...
| En-tête : | #include <QDBusPendingCall> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS DBus) target_link_libraries(mytarget PRIVATE Qt6::DBus) |
| qmake : | QT += dbus |
| Hérité par : |
- Liste de tous les membres, y compris les membres hérités
- QDBusPendingCall fait partie des classes partagées implicitement.
Fonctions publiques
| QDBusPendingCall(const QDBusPendingCall &other) | |
(since 6.10) | QDBusPendingCall(QDBusPendingCall &&other) |
| ~QDBusPendingCall() | |
| void | swap(QDBusPendingCall &other) |
| QDBusPendingCall & | operator=(QDBusPendingCall &&other) |
| QDBusPendingCall & | operator=(const QDBusPendingCall &other) |
Membres publics statiques
| QDBusPendingCall | fromCompletedCall(const QDBusMessage &msg) |
| QDBusPendingCall | fromError(const QDBusError &error) |
Description détaillée
Un objet QDBusPendingCall est une référence à un appel de méthode qui a été envoyé via D-Bus sans attendre de réponse. QDBusPendingCall est un type opaque, destiné à servir de descripteur pour une réponse en attente.
Dans la plupart des programmes, la classe QDBusPendingCall ne sera pas utilisée directement. Elle peut être remplacée sans risque par la classe QDBusPendingReply, basée sur un modèle, afin d’accéder au contenu de la réponse ou d’attendre qu’elle soit complète.
La classe ` QDBusPendingCallWatcher ` permet de se connecter à un signal qui indiquera quand la réponse est arrivée ou si l’appel a expiré. Elle fournit également la méthode ` QDBusPendingCallWatcher::waitForFinished()` qui suspendra l’exécution du programme jusqu’à l’arrivée de la réponse.
Remarque : si vous créez une copie d'un objet `QDBusPendingCall`, toutes les informations seront partagées entre les différentes copies. Par conséquent, `QDBusPendingCall` est un objet explicitement partagé et ne fournit pas de méthode permettant de dissocier les copies (puisqu'elles font référence au même appel en attente).
Voir également QDBusPendingReply et QDBusPendingCallWatcher.
Documentation des fonctions membres
QDBusPendingCall::QDBusPendingCall(const QDBusPendingCall &other)
Crée une copie de l'appel asynchrone en attente de l'other. Notez que les deux objets feront référence au même appel en attente.
[constexpr noexcept default, since 6.10] QDBusPendingCall::QDBusPendingCall(QDBusPendingCall &&other)
Déplace l'other dans cet objet.
Remarque : l'objet d'origine other est placé dans un état partiellement formé, dans lequel les seules opérations valides sont la destruction et l'affectation d'une nouvelle valeur.
Cette fonction a été introduite dans Qt 6.10.
[noexcept] QDBusPendingCall::~QDBusPendingCall()
Détruit cette copie de l'objet ` QDBusPendingCall `. Si cette copie est également la dernière copie d'un appel asynchrone en attente, l'appel sera annulé et aucune autre notification ne sera reçue. Il ne sera alors plus possible d'accéder au contenu de la réponse lorsqu'elle arrivera.
[static] QDBusPendingCall QDBusPendingCall::fromCompletedCall(const QDBusMessage &msg)
Crée un objet ` QDBusPendingCall ` à partir du message ` msg`. Le message doit être de type ` QDBusMessage::ErrorMessage ` ou ` QDBusMessage::ReplyMessage ` (c'est-à-dire un message caractéristique d'un appel terminé).
Cette fonction est utile pour le code qui nécessite de simuler un appel en attente, mais qui est déjà terminé.
Voir également fromError().
[static] QDBusPendingCall QDBusPendingCall::fromError(const QDBusError &error)
Crée un objet ` QDBusPendingCall ` en fonction de la condition d'erreur error. L'objet d'appel en attente ainsi créé sera dans l'état « finished » et QDBusPendingReply<Types...>::isError() renverra `true`.
Voir également fromCompletedCall().
[noexcept] void QDBusPendingCall::swap(QDBusPendingCall &other)
Remplace cette instance d'appel en attente par other. Cette opération est très rapide et ne se solde jamais par un échec.
[noexcept] QDBusPendingCall &QDBusPendingCall::operator=(QDBusPendingCall &&other)
L'opération « Move-assign » transfère other vers QDBusPendingCall.
Remarque : l'objet d'origine other est placé dans un état partiellement formé, dans lequel les seules opérations valides sont la destruction et l'affectation d'une nouvelle valeur.
QDBusPendingCall &QDBusPendingCall::operator=(const QDBusPendingCall &other)
Crée une copie de l'appel asynchrone en attente other et supprime la référence à l'appel précédemment référencé. Notez qu'après l'exécution de cette fonction, les deux objets feront référence au même appel en attente.
Si cet objet contenait la dernière référence d’un appel asynchrone en attente, celui-ci sera annulé et aucune autre notification ne sera reçue. Il ne sera alors plus possible d’accéder au contenu de la réponse lorsqu’elle arrivera.
© 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.
