이 페이지에서

Qt Quick 위젯 예시

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

MDI 하위 창에서 디지털 시계와 회전하는 직사각형

이 예제는 Qt Widgets 애플리케이션 내에 Qt Quick 장면을 삽입하는 방법과, Qt Widgets 및 Qt Quick 간에 다양한 UI 요소가 어떻게 통합되는지를 보여줍니다. 여기에는 다음이 포함됩니다:

예제 실행

다음 위치에서 예제를 실행할 수 있습니다:

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 ’를 선택하십시오.

여러 개의 탭이 있는 하위 창이 포함된 MDI 창

예제 프로젝트 @ code.qt.io

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