Qt Quick 위젯 예시
QQuickWidget 클래스를 사용하여 Qt Quick 를 Qt Widgets 애플리케이션과 결합하는 방법을 보여줍니다.

이 예제는 Qt Widgets 애플리케이션 내에 Qt Quick 장면을 삽입하는 방법과, Qt Widgets 및 Qt Quick 간에 다양한 UI 요소가 어떻게 통합되는지를 보여줍니다. 여기에는 다음이 포함됩니다:
- Qt Widgets 과 Qt Quick
- 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: 튜토리얼: 빌드 및 실행을 참조하십시오.
Qt Quick 뷰 통합
Qt Quick 뷰의 원활한 통합을 시연하기 위해, 이 예제에서는 Qt Quick 뷰의 스크린샷을 캡처하는 여러 가지 방법을 구현합니다.
메인 메뉴에서 ‘ File ’를 선택한 다음, 다음 옵션 중 하나를 선택하여 ‘ Qt Quick ’ 뷰의 스크린샷을 캡처할 수 있습니다.
- Grab framebuffer - ` QQuickWidget::grabFramebuffer ` 함수를 사용하여 스크린샷을 캡처합니다.
- Render to pixmap - ` QWidget::render ` 함수를 사용하고 매개변수로 ` QPixmap ` 인스턴스를 전달하여 스크린샷을 캡처합니다. 이 방법은 ` Qt Widgets`에서 흔히 사용됩니다.
- Grab via grabToImage - QML 파일에 선언된 `
performLayerBasedGrab` 함수를 호출합니다. `performLayerBasedGrab` 함수는 QML Item의 ` Item::grabToImage ` 함수를 호출하여 스크린샷을 캡처합니다. 이 방식은 C++에서 중첩된 뷰의 QML API를 호출하는 방법을 보여줍니다.

MDI 환경의 QQuickWidget
이 예제는 또한 QQuickWidget 을 사용하여 하드웨어 가속 Qt Quick 장면을 Qt Widgets 다중 문서 인터페이스(MDI) 애플리케이션에 원활하게 통합하는 방법을 보여줍니다.
새로운 MDI 하위 창을 열려면 메인 메뉴에서 ‘ Window > Add tab widget ’를 선택하십시오.

© 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.