QML 프리뷰어 예제
QWidget::createWindowContainer()을 사용하여 Qt Quick 를 Qt Widgets 애플리케이션과 결합하는 방법을 보여줍니다.

이 예제는 Qt Quick 장면을 Qt Widgets 애플리케이션 내에 임베드하는 방법과, Qt Widgets 및 Qt Quick 간에 다양한 UI 요소가 어떻게 통합되는지를 보여줍니다. 여기에는 다음이 포함됩니다:
- Qt Widgets 간의 탭 포커싱 및 Qt Quick
- Qt Widgets 과 간의 드래그 앤 드롭 Qt Quick
- 임베디드 QML 파일에 정의된 단축키
- QQuickView 를 QLayout
예제 실행
다음 위치에서 예제를 실행할 수 있습니다:
- Qt Creator
Welcome 모드를 열고 Examples 에서 예제를 선택하십시오. 자세한 내용은 Qt Creator: 튜토리얼: 빌드 및 실행을 참조하십시오.
- Qt Extension for Visual Studio Code
Command Palette 에서 Qt: Open Qt examples 명령을 실행하고 목록에서 예제를 선택하십시오. 자세한 내용은 Qt Extension for Visual Studio Code: 튜토리얼: 빌드 및 실행을 참조하십시오.
UI 안내
예제의 메인 창 왼쪽에는 미리 볼 QML 파일을 선택할 수 있는 파일 탐색기가 있습니다. 오른쪽에는 QQuickWidget 에서 QML 콘텐츠가 표시됩니다. 버튼 클릭, 텍스트 입력, QML 파일에 정의된 단축키 사용 등 QML 콘텐츠와 상호작용할 수 있습니다.
또한 이 예제는 Qt Widgets 와 Qt Quick 컴포넌트 간에 포커스 및 입력 이벤트를 처리하여 원활한 사용자 경험을 보장하는 방법을 보여줍니다.
QWidget::createWindowContainer()도 참조하십시오 .
© 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.