버전 관리 체계
버전
Qt Quick Controls 2.0은 Qt 5.7에서 도입되었습니다. 이후 Qt의 마이너 릴리스가 나올 때마다 Qt Quick Controls 모듈의 임포트 버전이 1씩 증가하며, Qt 5.12부터는 임포트 버전이 Qt의 마이너 버전과 일치하게 됩니다.
Qt 6에서는 메이저 버전과 마이너 버전이 일치하며, Qml에서 임포트 시 버전 번호를 생략할 수 있습니다. 버전을 생략하면 최신 버전이 사용됩니다.
실험적인 Qt Labs 모듈은 임포트 버전 1.0을 사용합니다.
Qt | QtQuick | QtQuick.Controls,QtQuick.Controls.Material,QtQuick.Controls.Universal,QtQuick.Templates | Qt.labs.platform |
|---|---|---|---|
| 5.7 | 2.7 | 2.0 | 1.0 |
| 5.8 | 2.8 | 2.1 | 1.0 |
| 5.9 | 2.9 | 2.2 | 1.0 |
| 5.10 | 2.10 | 2.3 | 1.0 |
| 5.11 | 2.11 | 2.4 | 1.0 |
| 5.12 | 2.12 | 2.12 | 1.0 |
| 6.0 | 6.0 | 6.0 | 1.0 |
| ... | ... | ... | ... |
수정 내역
Qt Quick Controls 의 구현 방식상, 새로 추가된 속성은 동일한 이름을 가진 사용자 정의 속성과 충돌할 수 있습니다. 예를 들어, 다음 코드 조각은 오류를 발생시킵니다:
import QtQuick.Controls 2.13
ApplicationWindow {
// ...
ComboBox {
anchors.centerIn: parent
// As currentValue was added in 2.14, the versioned import above
// should cause this property to be used, but instead an error is produced:
// "Cannot override FINAL property"
property int currentValue: 0
}
}이러한 속성은 충돌을 피하기 위해 이름을 변경해야 합니다.
© 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.
