이 페이지에서

Qt Quick 위젯 예제

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

MDI 하위 창의 디지털 시계 및 회전 사각형

이 예에서는 Qt Widgets 애플리케이션 내에 Qt Quick 장면을 삽입하는 방법과 Qt WidgetsQt Quick 간에 서로 다른 UI 측면을 통합하는 방법을 보여줍니다. 여기에는 다음이 포함됩니다:

예제 실행하기

에서 예제를 실행하려면 Qt Creator에서 Welcome 모드를 열고 Examples 에서 예제를 선택합니다. 자세한 내용은 Qt Creator: 튜토리얼을 참조하세요 : 빌드 및 실행을 참조하세요.

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