QML Connections Element

Detailed Description

A Connections object creates a connection to a QML signal.

When connecting to signals in QML, the usual way is to create an "on<Signal>" handler that reacts when a signal is received, like this:

 MouseArea {
     onClicked: { foo(parameters) }
 }

However, it is not possible to connect to a signal in this way in some cases, such as when:

• Multiple connections to the same signal are required
• Creating connections outside the scope of the signal sender
• Connecting to targets not defined in QML

When any of these are needed, the Connections element can be used instead.

For example, the above code can be changed to use a Connections object, like this:

 MouseArea {
     Connections {
         onClicked: foo(parameters)
     }
 }

More generally, the Connections object can be a child of some object other than the sender of the signal:

 MouseArea {
     id: area
 }
 // ...

 Connections {
     target: area
     onClicked: foo(parameters)
 }

See also QtDeclarative.

Property Documentation