このページでは

C

Connections QML Type

QML シグナルをハンドラに接続できるようにします。詳細...

Import Statement: import QtQuick
Since: Qt Quick Ultralite 1.0

プロパティ

詳細説明

Connections オブジェクトは QML シグナルをハンドラに接続します。

通常、QMLのシグナルは "on<Signal>"ハンドラに接続されます。次の例のようにです:

MouseArea {
   onClicked: { foo(parameters) }
}

しかし、次のような場合には、on<Signal> ハンドラを使用することはできません:

  • 同じシグナルに複数の接続を追加する
  • 同じシグナルに複数のコネクションを追加する。
  • QMLで定義されていないターゲットへの接続

これらの場合、代わりにConnections型を使用してください。

例えば、先ほどの例を修正して、次のようにConnectionsオブジェクトを使用することができます:

MouseArea {
    id: mouseArea
    Connections {
        target: mouseArea
        function onClicked(mouse: MouseEvent) { foo(mouse) }
    }
}

一般に、Connectionsオブジェクトは、シグナルの送信者以外のオブジェクトの子オブジェクトとすることができます:

MouseArea {
    id: area
}
// ...
Connections {
    target: area
    function onClicked(mouse: MouseEvent) { foo(mouse) }
}

注意: 後方互換性のために、シグナルハンドラをターゲットオブジェクトに直接指定するように、関数なしで指定することもできます。これは推奨されません。この方法で1つのシグナル・ハンドラを指定すると、同じコネクション・オブジェクトでfunctionとして指定されたシグナル・ハンドラはすべて無視されます。

プロパティ Documentation

target : Object

このプロパティは、シグナルを送信するオブジェクトを保持します。

ターゲットのid 、またはシングルトン・オブジェクトに設定する必要があります。


特定の Qt ライセンスの下で利用可能です。
詳細を確認してください。