QQuickWidget - QQuickView 비교 예시
기본 창으로 임베드된 QQuickView 보다 QQuickWidget 의 이점을 보여줍니다.

이 예에서는 두 가지 다른 접근 방식을 사용하여 동일한 QWidget 기반 사용자 인터페이스 내에서 동일한 Qt Quick 장면을 표시할 수 있습니다:
- QQuickView.
자식 창으로 사용 및 QWidget::createWindowContainer()와 함께 사용
- 사용 QQuickWidget.
진정한 QWidget 처럼 작동하며, 무엇보다도 진정한 QWidget 에서 예상되는 것처럼 더 나은 클리핑 및 스태킹을 지원합니다.
Show widget overlay 확인란을 클릭하면 네이티브 창을 포함할 때 예상대로 렌더링되지 않는 위젯 스태킹 사례를 보여 주며, QQuickWidget 을 사용하면 예상대로 렌더링됩니다.
예제 실행하기
에서 예제를 실행하려면 Qt Creator에서 예제를 실행하려면 Welcome 모드를 열고 Examples 에서 예제를 선택합니다. 자세한 내용은 Qt Creator: 튜토리얼을 참조하세요 : 빌드 및 실행을 참조하세요.
플랫폼 참고 사항
Qt Quick 씬은 QQuickWidget 과 함께 임베드된 경우에도 직접 OpenGL 렌더링을 사용합니다. 이는 렌더링이 가속화된 3D API를 계속 사용한다는 것을 확인합니다.
따라서 이 예제는 OpenGL에 묶여 있으며 Vulkan, Metal 또는 Direct3D와 같은 다른 그래픽 API에서는 작동하지 않습니다.
멀티샘플 앤티앨리어싱
해당 확인란을 선택하여 멀티샘플 앤티앨리어싱을 활성화할 수 있습니다. 활성화하면 QQuickWidget 콘텐츠가 멀티샘플 렌더버퍼로 렌더링됩니다. 각 렌더링 패스 후에 콘텐츠는 표준 2D 텍스처로 리졸브됩니다. 이렇게 하면 나머지 QWidget 기반 UI에는 영향을 주지 않고 Qt Quick 콘텐츠에 앤티앨리어싱을 적용할 수 있습니다.
QQuickView 을 사용하는 경우 네이티브 창은 표면에 대한 멀티샘플링을 요청합니다. 이는 플랫폼 지원에 따라 비슷한 결과를 제공합니다.
키보드 입력
Qt Quick 장면은 사용된 임베딩 기술에 관계없이 텍스트 입력을 포함한 사용자 상호 작용을 지원합니다. QQuickWidget 을 사용하는 경우 입력 이벤트는 Qt Quick 씬으로 자동 전달됩니다.
Qt Quick 위젯을참조하세요 .
© 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.