QDBusInterface Class

QDBusInterface クラスは、リモート・オブジェクトのインターフェースのプロキシです。詳細...

Header:	`#include <QDBusInterface>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS DBus)` `target_link_libraries(mytarget PRIVATE Qt6::DBus)`
qmake:	`QT += dbus`
Inherits:	QDBusAbstractInterface

継承メンバを含む全メンバのリスト

パブリック関数

	QDBusInterface(const QString &service, const QString &path, const QString &interface = QString(), const QDBusConnection &connection = QDBusConnection::sessionBus(), QObject *parent = nullptr)
virtual	~QDBusInterface()

詳細説明

QDBusInterface は、リモート・オブジェクトへの呼び出し、リモート・オブジェクトによってエクスポートされるシグナルへの接続、リモート・プロパティの値の取得/設定に使用される汎用アクセッサ・クラスです。このクラスは、リモート・オブジェクトへの動的なアクセス、つまりリモート・インターフェースを表す生成コードがない場合に便利です。

呼び出しは通常、call （）関数を使用して行われます。（）関数は、メッセージを構築し、バス経由で送信し、応答を待ち、応答をデコードします。シグナルの接続には、通常のQObject::connect （）関数を使用する。最後に、QObject::property （）関数とQObject::setProperty （）関数を使用してプロパティにアクセスします。

次のコード・スニペットは、セッション・バスを介してアクセスされるcom.example.Calculator というリモート・アプリケーションで、"2 + 2" の数学演算を実行する方法を示しています。

QDBusInterface remoteApp( "com.example.Calculator", "/Calculator/Operations",
                          "org.mathematics.RPNCalculator" );
remoteApp.call( "PushOperand", 2 );
remoteApp.call( "PushOperand", 2 );
remoteApp.call( "ExecuteOperation", "+" );
QDBusReply<int> reply = remoteApp.call( "PopOperand" );

if ( reply.isValid() )
    printf( "%d", reply.value() );          // prints 4

Qt D-Bus XML コンパイラ (qdbusxml2cpp)も参照してください 。

メンバ関数ドキュメント

QDBusInterface::QDBusInterface(const QString &service, const QString &path, const QString &interface = QString(), const QDBusConnection &connection = QDBusConnection::sessionBus(), QObject **parent* = nullptr)

与えられたconnection を使用して、サービスservice 上のパスpath にあるオブジェクト上のインターフェイスinterface に関連付けられた動的 QDBusInterface オブジェクトを作成します。interface が空文字列の場合、作成されたオブジェクトは、そのオブジェクトをイントロスペクトして見つかったすべてのインターフェースのマージを参照します。そうでない場合、interface が空でなければ、QDBusInterface オブジェクトはキャッシュされ、同じインタフェースの作成が高速化されます。

parent はベース・クラスのコンストラクタに渡されます。

リモート・サービスservice が存在しない場合、またはリモート・インターフェースの記述interface を取得しようとしてエラーが発生した場合、作成されたオブジェクトは無効となります（isValid() を参照）。

`[virtual noexcept]` QDBusInterface::~QDBusInterface()

オブジェクト・インターフェースを破棄し、使用されているリソースを解放します。

本書に含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。