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

メンバ関数ドキュメント

QDBusContext::QDBusContext()

空の QDBusContext を構築します。

[noexcept] QDBusContext::~QDBusContext()

空のデストラクタ。

bool QDBusContext::calledFromDBus() const

Dバス・コールを処理している場合、true を返す。この関数がtrue を返した場合、このクラスの残りの関数を使用できます。

この関数がfalse を返したときにこれらの関数にアクセスすることは未定義であり、クラッシュにつながる可能性があります。

QDBusConnection QDBusContext::connection() const

このコールを受信したコネクションを返します。

bool QDBusContext::isDelayedReply() const

このコールに遅延応答がある場合はtrue を返す。

setDelayedReply()も参照のこと 。

const QDBusMessage &QDBusContext::message() const

この呼び出しを発生させたメッセージを返す。

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

呼び出し元への応答としてエラーname を送る。オプションのパラメータmsg は、失敗を説明する人間が読めるテキストである。

エラーが送信された場合、呼び出されたスロットの戻り値と出力パラメータは、Qt D-Bus によって無視される。

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

これはオーバーロードされた関数である。

呼び出し元への応答としてエラーtype を送る。オプションのパラメータmsg は、失敗を説明する人間が読めるテキストです。

エラーが送信された場合、呼び出されたスロットの戻り値と出力パラメータはQt D-Bus によって無視されます。

void QDBusContext::setDelayedReply(bool enable) const

この呼が遅延応答を持つかどうかを設定する。

enable がfalseの場合、Qt D-Bus は、呼び出されたスロットが戻るとすぐに、必要であれば、呼び出し元への返信を自動的に生成する。

enable がtrueの場合、Qt D-Bus は自動返信を生成しない。また、スロットからの戻り値や出力パラメータも無視します。代わりに、呼び出されたオブジェクトは、受信メッセージを保存し、後で返信またはエラーを送信する責任を負います。

応答を送信しないと、D-Busによって自動タイムアウト・エラーが生成されます。

isDelayedReply()も参照のこと 。