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();
}

Dokumentation der Mitgliedsfunktionen

QDBusContext::QDBusContext()

Erstellt einen leeren QDBusContext.

[noexcept] QDBusContext::~QDBusContext()

Ein leerer Destruktor.

bool QDBusContext::calledFromDBus() const

Gibt „ true “ zurück, wenn ein D-Bus-Aufruf verarbeitet wird. Wenn diese Funktion „ true “ zurückgibt, stehen die übrigen Funktionen dieser Klasse zur Verfügung.

Der Zugriff auf diese Funktionen, wenn diese Funktion false zurückgibt, ist nicht definiert und kann zu Abstürzen führen.

QDBusConnection QDBusContext::connection() const

Gibt die Verbindung zurück, über die dieser Aufruf eingegangen ist.

bool QDBusContext::isDelayedReply() const

Gibt „ true “ zurück, wenn dieser Aufruf eine verzögerte Antwort liefert.

Siehe auch setDelayedReply().

const QDBusMessage &QDBusContext::message() const

Gibt die Meldung zurück, die diesen Aufruf ausgelöst hat.

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

Sendet einen Fehler name als Antwort an den Aufrufer. Der optionale Parameter „ msg “ ist ein für Menschen lesbarer Text, der den Fehler erklärt.

Wird ein Fehler gesendet, werden der Rückgabewert und alle Ausgabeparameter des aufgerufenen Slots von ` Qt D-Bus` ignoriert.

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

Sendet einen Fehler type als Antwort an den Aufrufer. Der optionale Parameter ` msg ` ist ein für Menschen lesbarer Text, der den Fehler erklärt.

Wird ein Fehler gesendet, werden der Rückgabewert und alle Ausgabeparameter des aufgerufenen Slots von ` Qt D-Bus` ignoriert.

void QDBusContext::setDelayedReply(bool enable) const

Legt fest, ob dieser Aufruf eine verzögerte Antwort erhält oder nicht.

Ist „ enable “ auf „false“ gesetzt, generiert „ Qt D-Bus “ bei Bedarf automatisch eine Antwort an den Aufrufer, sobald der aufgerufene Slot zurückkehrt.

Ist „ enable “ auf „true“ gesetzt, generiert „ Qt D-Bus “ keine automatischen Antworten. Außerdem werden der Rückgabewert des Slots sowie alle Ausgabeparameter ignoriert. Stattdessen ist das aufgerufene Objekt dafür verantwortlich, die eingehende Nachricht zu speichern und zu einem späteren Zeitpunkt eine Antwort oder eine Fehlermeldung zu senden.

Wird keine Antwort gesendet, löst D-Bus automatisch einen Timeout-Fehler aus.

Siehe auch isDelayedReply().