Connections QML 类型

描述信号的一般化连接。 更多...

import 语句: import QtQml 2.2

特性

详细描述

Connections 对象创建到 QML 信号的连接。

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: (mouse)=> { foo(mouse) }
}
					

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 type can be used instead.

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

MouseArea {
    Connections {
        function onClicked(mouse) { foo(mouse) }
    }
}
					

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
    function onClicked(mouse) { foo(mouse) }
}
					

另请参阅 Qt QML .

特性文档编制

[since 5.7] enabled : bool

此特性保持项是否接受改变事件。

默认情况下,此特性为 true .

该特性在 Qt 5.7 引入。

ignoreUnknownSignals : bool

Normally, a connection to a non-existent signal produces runtime errors.

If this property is set to true , such errors are ignored. This is useful if you intend to connect to different types of objects, handling a different set of signals for each object.

target : 对象

此特性保持发送信号的对象。

如果未设置此特性, target 默认为连接的父级。

If set to null, no connection is made and any signal handlers are ignored until the target is not null.