버전 관리 체계

버전

Qt Quick Controls 2.0은 Qt 5.7에 도입되었습니다. 이후의 마이너 Qt 릴리스에서는 Qt Quick Controls 모듈의 임포트 버전이 한 단계씩 증가하여, Qt 5.12에서는 임포트 버전이 Qt의 마이너 버전과 일치하게 됩니다.

Qt 6에서는 메이저 버전과 마이너 버전이 모두 일치하며, Qt 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.