이 페이지에서

Connections QML Type

신호와의 일반적인 연결 관계를 설명합니다. 더 보기...

Import Statement: import QtQml

속성

상세 설명

Connections 객체는 QML 신호에 대한 연결을 생성합니다.

QML에서 시그널에 연결할 때 일반적인 방법은 다음과 같이 시그널이 수신되면 반응하는 "on<Signal>" 핸들러를 생성하는 것입니다:

MouseArea {
    onClicked: (mouse)=> { foo(mouse) }
}

그러나 다음과 같은 경우에는 이러한 방식으로 신호에 연결할 수 없습니다:

  • 동일한 신호에 대한 여러 개의 연결이 필요한 경우
  • 신호 발신자의 범위 밖에서 연결을 생성해야 하는 경우
  • QML에 정의되지 않은 대상에 연결해야 하는 경우

이러한 경우 중 하나라도 필요한 경우, 대신 Connections 타입을 사용할 수 있습니다.

예를 들어, 위의 코드를 다음과 같이 수정하여 Connections 객체를 사용할 수 있습니다:

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

보다 일반적으로, Connections 객체는 신호 발신자가 아닌 다른 객체의 자식 객체가 될 수 있습니다:

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

참고: 하위 호환성을위해 , 대상 객체에 직접 지정하는 것처럼 ` function`를 생략하고 신호 핸들러를 지정할 수도 있습니다. 그러나 이 방법은 권장되지 않습니다. 이 방법으로 하나의 신호 핸들러를 지정하면, 동일한 Connections 객체 내에서 ` function `로 지정된 모든 신호 핸들러는 무시됩니다.

참조: Qt Qml.

속성 설명서

enabled : bool

이 속성은 해당 항목이 변경 이벤트를 수신하는지 여부를 나타냅니다.

기본적으로 이 속성의 값은 ` true`입니다.

ignoreUnknownSignals : bool

일반적으로 존재하지 않는 신호에 연결하면 런타임 오류가 발생합니다.

이 속성을 ` true`로 설정하면 이러한 오류가 무시됩니다. 이는 서로 다른 유형의 객체에 연결하여 각 객체마다 다른 신호 집합을 처리하려는 경우에 유용합니다.

target : QtObject

이 속성은 신호를 보내는 객체를 포함합니다.

이 속성이 설정되지 않은 경우, ` target `는 기본적으로 `Connection`의 부모 객체로 설정됩니다.

null로 설정된 경우, 연결이 이루어지지 않으며 대상이 null이 아닐 때까지 모든 신호 핸들러가 무시됩니다.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.