Qt Qml 디자인 지원
Qt Qml 의 디자인 지원 모듈은 QML에서 객체를 등록하고 참조하기 위한 일련의 타입을 제공하여 디자인 툴링을 지원합니다. 객체는 등록 시 키 문자열로 식별되며, 참조 타입은 이 키를 사용하여 등록된 객체에 대한 참조를 얻을 수 있습니다. 이는 특히 UI 코드가 특정 도구를 통해 자동 생성되고 개발자가 이를 수동으로 수정할 필요가 없는 경우, UI 코드와 비즈니스 로직을 명확하게 분리할 수 있도록 하기 위한 것입니다. Qt Qml 디자인 지원 모듈은 등록된 객체를 참조하기 위한 QML API와 C++ API를 모두 제공합니다. 객체 등록 기능은 QML API로만 사용할 수 있습니다.
Qt Qml 디자인 지원 모듈은 Qt 6.12에서 도입되었습니다.
모듈 사용 방법
QML API
이 모듈의 QML 타입은 ` QtQml.DesignSupport ` 임포트를 통해 사용할 수 있습니다. 해당 타입을 사용하려면 .qml 파일에 다음 임포트 문장을 추가하십시오:
import QtQml.DesignSupportQt Qml 디자인 지원 모듈의 QML API는 QML 객체를 등록하고 등록된 QML 객체를 참조하는 데 필요한 유형을 제공합니다.
C++ API
Qt 모듈의 C++ API를 사용하려면 모듈 라이브러리를 직접 또는 다른 종속성을 통해 링크해야 합니다. CMake 및 qmake를 비롯한 여러 빌드 도구가 이를专门으로 지원합니다.
Qt Qml 디자인 지원 모듈의 C++ API는 등록된 QML 객체를 참조하는 데 필요한 클래스를 제공합니다.
CMake를 사용한 빌드
` find_package() ` 명령을 사용하여 ` Qt6 ` 패키지 내에서 필요한 모듈 구성 요소를 찾으십시오:
find_package(Qt6 REQUIRED COMPONENTS QmlDesignSupport)
target_link_libraries(mytarget PRIVATE Qt6::QmlDesignSupport)자세한 내용은 ‘CMake를 사용한 빌드’ 개요를 참조하십시오.
qmake를 사용한 빌드
qmake를 사용하여 모듈을 빌드하도록 구성하려면, 프로젝트의 .pro 파일에서 QT 변수의 값으로 해당 모듈을 추가하십시오:
QT += qmldesignsupportAPI 참조
라이선스 및 저작권 표시
Qt Qml Design Support는 The Qt Company의 상용 라이선스에 따라 제공됩니다. 또한, GNU Lesser General Public License 버전 3 또는 GNU General Public License 버전 2에 따라 사용할 수도 있습니다. 자세한 내용은 Qt 라이선싱을 참조하십시오.
© 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.