QQuickWidget Class

QQuickWidget *view = new QQuickWidget;
view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
view->show();

멤버 함수 설명서

[explicit] QQuickWidget::QQuickWidget(QWidget *parent = nullptr)

parent 의 자식 요소로 기본 QML 엔진을 사용하는 QQuickWidget을 생성합니다.

parent 의 기본값은 nullptr 입니다.

QQuickWidget::QQuickWidget(QQmlEngine *engine, QWidget *parent)

지정된 QML ` engine `을 ` parent`의 자식으로 갖는 `QQuickWidget`을 생성합니다.

[explicit] QQuickWidget::QQuickWidget(const QUrl &source, QWidget *parent = nullptr)

기본 QML 엔진과 지정된 QML source 를 사용하여 parent 의 자식 요소로 QQuickWidget을 생성합니다.

parent 의 기본값은 nullptr 입니다.

[explicit, since 6.9] QQuickWidget::QQuickWidget(QAnyStringView uri, QAnyStringView typeName, QWidget *parent = nullptr)

uri 와 typeName 로 지정된 요소와 부모 parent 를 사용하여 QQuickWidget을 생성합니다. parent 의 기본값은 nullptr 입니다.

이 함수는 Qt 6.9에서 도입되었습니다.

loadFromModule도 참조하십시오 .

[override virtual noexcept] QQuickWidget::~QQuickWidget()

QQuickWidget 를 삭제합니다.

[override virtual protected] void QQuickWidget::dragEnterEvent(QDragEnterEvent *e)

QWidget::dragEnterEvent(QDragEnterEvent *event)를 재구현합니다.

[override virtual protected] void QQuickWidget::dragLeaveEvent(QDragLeaveEvent *e)

QWidget::dragLeaveEvent(QDragLeaveEvent *event)를 재구현합니다.

[override virtual protected] void QQuickWidget::dragMoveEvent(QDragMoveEvent *e)

QWidget::dragMoveEvent(QDragMoveEvent *event)를 재구현합니다.

[override virtual protected] void QQuickWidget::dropEvent(QDropEvent *e)

QWidget::dropEvent(QDropEvent *event)를 재구현합니다.

QQmlEngine *QQuickWidget::engine() const

QML 컴포넌트를 인스턴스화하는 데 사용되는 ` QQmlEngine `에 대한 포인터를 반환합니다.

QList<QQmlError> QQuickWidget::errors() const

마지막 컴파일 또는 생성 작업 중에 발생한 오류 목록을 반환합니다. 상태가 ` Error`이 아닐 경우, 빈 목록이 반환됩니다.

status도 참조하십시오 .

[override virtual protected] bool QQuickWidget::event(QEvent *e)

QWidget::event(QEvent *event)를 재구현합니다.

[override virtual protected] void QQuickWidget::focusInEvent(QFocusEvent *event)

QWidget::focusInEvent(QFocusEvent *event)를 재구현합니다.

[override virtual protected] bool QQuickWidget::focusNextPrevChild(bool next)

QWidget::focusNextPrevChild(bool next)를 재구현합니다.

[override virtual protected] void QQuickWidget::focusOutEvent(QFocusEvent *event)

QWidget::focusOutEvent(QFocusEvent *event)를 재구현합니다.

QSurfaceFormat QQuickWidget::format() const

실제 표면 형식을 반환합니다.

위젯이 아직 표시되지 않은 경우, 요청된 형식이 반환됩니다.

setFormat()도 참조하십시오 .

QImage QQuickWidget::grabFramebuffer() const

프레임을 렌더링하고 이를 다시 이미지로 읽어옵니다.

[override virtual protected] void QQuickWidget::hideEvent(QHideEvent *)

QWidget::hideEvent(QHideEvent *event)를 재구현합니다.

QSize QQuickWidget::initialSize() const

루트 객체의 초기 크기를 반환합니다.

resizeMode 가 ` SizeRootObjectToView`인 경우, 루트 객체의 크기가 뷰의 크기에 맞춰 조정됩니다. 이 함수는 크기가 조정되기 전 루트 객체의 크기를 반환합니다.

[override virtual protected] void QQuickWidget::keyPressEvent(QKeyEvent *e)

QWidget::keyPressEvent(QKeyEvent *event)를 재구현합니다.

[override virtual protected] void QQuickWidget::keyReleaseEvent(QKeyEvent *e)

QWidget::keyReleaseEvent(QKeyEvent *event)를 재구현합니다.

[slot, since 6.9] void QQuickWidget::loadFromModule(QAnyStringView uri, QAnyStringView typeName)

uri 및 typeName 로 식별되는 QML 컴포넌트를 불러옵니다. 컴포넌트가 QML 파일로 뒷받침되는 경우, source 가 그에 따라 설정됩니다. C++ 에 정의된 유형의 경우, source 는 비어 있습니다.

이 메서드가 호출되기 전에 source 가 설정된 경우, 해당 값은 지워집니다.

동일한 uri 및 typeName 을 사용하여 이 메서드를 여러 번 호출하면 QML 컴포넌트가 재인스턴스화됩니다.

이 함수는 Qt 6.9에서 도입되었습니다.

setSource, QQmlComponent::loadFromModule 및 QQmlApplicationEngine::loadFromModule도 참조하십시오 .

[override virtual protected] void QQuickWidget::mouseDoubleClickEvent(QMouseEvent *e)

QWidget::mouseDoubleClickEvent(QMouseEvent *event)를 재구현합니다.

[override virtual protected] void QQuickWidget::mouseMoveEvent(QMouseEvent *e)

QWidget::mouseMoveEvent(QMouseEvent *event)를 재구현합니다.

[override virtual protected] void QQuickWidget::mousePressEvent(QMouseEvent *e)

QWidget::mousePressEvent(QMouseEvent *event)를 재구현합니다.

[override virtual protected] void QQuickWidget::mouseReleaseEvent(QMouseEvent *e)

QWidget::mouseReleaseEvent(QMouseEvent *event)를 재구현합니다.

[override virtual protected] void QQuickWidget::paintEvent(QPaintEvent *event)

QWidget::paintEvent(QPaintEvent *event)를 재구현합니다.

QQuickWindow *QQuickWidget::quickWindow() const

이 위젯이 Qt Quick 렌더링을 구동하는 데 사용하는 오프스크린 QQuickWindow 을 반환합니다. 이는 QQuickWidget 에서 현재 노출되지 않은 QQuickWindow API를 사용하고자 할 때 유용합니다. 예를 들어, Qt Quick 의 자체 렌더링 아래에 네이티브 OpenGL 콘텐츠를 그리기 위해 QQuickWindow::beforeRendering() 신호에 연결하는 경우 등이 있습니다.

QQmlContext *QQuickWidget::rootContext() const

이 함수는 컨텍스트 계층 구조의 최상위 노드를 반환합니다. 각 QML 컴포넌트는 ` QQmlContext` 내에서 인스턴스화됩니다. ` QQmlContext`는 QML 컴포넌트에 데이터를 전달하는 데 필수적입니다. QML에서 컨텍스트는 계층적으로 구성되며, 이 계층 구조는 ` QQmlEngine`에 의해 관리됩니다.

QQuickItem *QQuickWidget::rootObject() const

뷰의 루트 item 를 반환합니다. setSource()이 호출되지 않았거나, QtQuick 코드가 오류가 있는 상태로 호출되었거나, 루트 항목이 다른 이유로 정의되지 않은 경우 nullptr 가 반환될 수 있습니다.

[signal] void QQuickWidget::sceneGraphError(QQuickWindow::SceneGraphError error, const QString &message)

이 신호는 씬 그래프 초기화 중에 error 가 발생했을 때 발송됩니다.

애플리케이션에서 OpenGL 컨텍스트 생성 실패와 같은 오류를 사용자 정의 방식으로 처리하려면 이 신호에 연결해야 합니다. 이 신호에 슬롯이 연결되어 있지 않은 경우 동작이 달라집니다. Quick은 message 를 출력하거나 메시지 상자를 표시한 후 애플리케이션을 종료합니다.

이 신호는 GUI 스레드에서 발생합니다.

QQuickWindow::sceneGraphError()도 참조하십시오 .

void QQuickWidget::setClearColor(const QColor &color)

color 을 투명하게 설정합니다. 기본적으로 이 색상은 불투명합니다.

반투명한 QQuickWidget 를 얻으려면, color 를 Qt::transparent 로 설정하고 이 함수를 호출한 다음, 최상위 창에서 Qt::WA_TranslucentBackground 위젯 속성을 설정하고, setFormat()를 통해 알파 채널을 요청하십시오.

QQuickWindow::setColor()도 참조하십시오 .

void QQuickWidget::setFormat(const QSurfaceFormat &format)

이 위젯에서 사용하는 컨텍스트 및 오프스크린 표면의 표면 format 를 설정합니다.

주어진 OpenGL 버전이나 프로파일에 대한 컨텍스트를 요청해야 할 때 이 함수를 호출하십시오. 깊이, 스텐실 및 알파 버퍼의 크기는 자동으로 처리되므로 이를 명시적으로 요청할 필요가 없습니다.

QWindow::setFormat(), QWindow::format(), format()도 참조하십시오 .

[slot, since 6.9] void QQuickWidget::setInitialProperties(const QVariantMap &initialProperties)

QQuickWidget::setSource()를 호출한 후 QML 컴포넌트가 초기화될 때 적용될 초기 속성 initialProperties 을 설정합니다.

이 함수는 Qt 6.9에서 도입되었습니다.

QQmlComponent::createWithInitialProperties()도 참조하십시오 .

[slot] void QQuickWidget::setSource(const QUrl &url)

소스를 url 로 설정하고, QML 컴포넌트를 불러온 다음 인스턴스를 생성합니다.

제공된 URL이 완전하고 정확한지 확인하십시오. 특히, 로컬 파일 시스템에서 파일을 불러올 때는 QUrl::fromLocalFile()을 사용하십시오.

동일한 URL로 이 메서드를 여러 번 호출하면 QML 컴포넌트가 다시 인스턴스화됩니다.

source()도 참조하십시오 .

[override virtual protected] void QQuickWidget::showEvent(QShowEvent *)

QWidget::showEvent(QShowEvent *event)를 재구현합니다.

QUrl QQuickWidget::source() const

설정된 경우 소스 URL을 반환합니다.

setSource()도 참조하십시오 .

[signal] void QQuickWidget::statusChanged(QQuickWidget::Status status)

이 신호는 컴포넌트의 현재 status 값이 변경될 때 발생합니다.

[override virtual protected] void QQuickWidget::wheelEvent(QWheelEvent *e)

QWidget::wheelEvent(QWheelEvent *event)를 재구현합니다.