QDBusContext Class

class MyObject: public QObject,
                protected QDBusContext
{
    Q_OBJECT

    QDBusConnection conn;
    QDBusMessage msg;

    //...

protected slots:
    void process();
public slots:
    void methodWithError();
    QString methodWithDelayedReply();
};

void MyObject::methodWithError()
{
    sendErrorReply(QDBusError::NotSupported,
                   "The method call 'methodWithError()' is not supported");
}

QString MyObject::methodWithDelayedReply()
{
    conn = connection();
    msg = message();
    setDelayedReply(true);
    QMetaObject::invokeMethod(this, &MyObject::process, Qt::QueuedConnection);
    return QString();
}

Documentation des fonctions membres

QDBusContext::QDBusContext()

Crée un objet QDBusContext vide.

[noexcept] QDBusContext::~QDBusContext()

Un destructeur vide.

bool QDBusContext::calledFromDBus() const

Renvoie « true » si nous traitons un appel D-Bus. Si cette fonction renvoie « true », les autres fonctions de cette classe sont disponibles.

L'accès à ces fonctions lorsque cette fonction renvoie false n'est pas défini et peut entraîner des plantages.

QDBusConnection QDBusContext::connection() const

Renvoie la connexion à partir de laquelle cet appel a été reçu.

bool QDBusContext::isDelayedReply() const

Renvoie « true » si cet appel donnera lieu à une réponse différée.

Voir également setDelayedReply().

const QDBusMessage &QDBusContext::message() const

Renvoie le message à l'origine de cet appel.

void QDBusContext::sendErrorReply(const QString &name, const QString &msg = QString()) const

Envoie une erreur de type « name » en réponse à l'appelant. Le paramètre facultatif « msg » est un texte lisible par l'utilisateur expliquant l'échec.

Si une erreur est renvoyée, la valeur de retour et tous les paramètres de sortie du slot appelé seront ignorés par ` Qt D-Bus`.

void QDBusContext::sendErrorReply(QDBusError::ErrorType type, const QString &msg = QString()) const

Envoie une erreur de type « type » en réponse à l'appelant. Le paramètre facultatif « msg » est un texte lisible par l'utilisateur expliquant l'échec.

Si une erreur est renvoyée, la valeur de retour et tous les paramètres de sortie du slot appelé seront ignorés par ` Qt D-Bus`.

void QDBusContext::setDelayedReply(bool enable) const

Détermine si cet appel fera l'objet d'une réponse différée ou non.

Si « enable » est faux, « Qt D-Bus » générera automatiquement une réponse à l'appelant, si nécessaire, dès que le slot appelé renvoie une valeur.

Si ` enable ` est vrai, ` Qt D-Bus ` ne générera pas de réponses automatiques. Il ignorera également la valeur de retour du slot et tous les paramètres de sortie. À la place, l'objet appelé est chargé de stocker le message entrant et d'envoyer une réponse ou une erreur ultérieurement.

Si aucune réponse n’est envoyée, D-Bus générera automatiquement une erreur de délai d’attente.

Voir également isDelayedReply().