QQuickWidget Class

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

멤버 함수 문서

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

기본 QML 엔진을 parent 의 자식으로 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 입니다.

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

QQuickWidget 를 파괴합니다.

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

다시 구현합니다: QWidget::dragEnterEvent(QDragEnterEvent * 이벤트).

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

다시 구현합니다: QWidget::dragLeaveEvent(QDragLeaveEvent * 이벤트).

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

다시 구현합니다: QWidget::dragMoveEvent(QDragMoveEvent * 이벤트).

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

다시 구현합니다: QWidget::dropEvent(QDropEvent * 이벤트).

QQmlEngine *QQuickWidget::engine() const

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

QList<QQmlError> QQuickWidget::errors() const

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

status 를참조하세요 .

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

다시 구현합니다: QWidget::event(QEvent * 이벤트).

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

다시 구현합니다: QWidget::focusInEvent(QFocusEvent * 이벤트).

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

다시 구현합니다: QWidget::focusNextPrevChild(다음 부울).

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

다시 구현합니다: QWidget::focusOutEvent(QFocusEvent * 이벤트).

QSurfaceFormat QQuickWidget::format() const

실제 서피스 형식을 반환합니다.

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

setFormat()도 참조하세요 .

QImage QQuickWidget::grabFramebuffer() const

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

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

다시 구현합니다: QWidget::hideEvent(QHideEvent * 이벤트).

QSize QQuickWidget::initialSize() const

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

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

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

다시 구현합니다: QWidget::keyPressEvent(QKeyEvent * 이벤트).

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

다시 구현합니다: QWidget::keyReleaseEvent(QKeyEvent * 이벤트).

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

다시 구현합니다: QWidget::mouseDoubleClickEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QWidget::mouseMoveEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QWidget::mousePressEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QWidget::mouseReleaseEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QWidget::paintEvent(QPaintEvent * 이벤트).

QQuickWindow *QQuickWidget::quickWindow() const

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

QQmlContext *QQuickWidget::rootContext() const

이 함수는 컨텍스트 계층 구조의 루트를 반환합니다. 각 QML 컴포넌트는 QQmlContext 에서 인스턴스화됩니다. QQmlContext 은 QML 컴포넌트에 데이터를 전달하는 데 필수적입니다. QML에서 컨텍스트는 계층적으로 배열되며 이 계층 구조는 QQmlEngine 에서 관리합니다.

QQuickItem *QQuickWidget::rootObject() const

뷰의 루트 item 를 반환합니다. setSource ()가 호출되지 않은 경우, 깨진 QtQuick 코드와 함께 호출된 경우 또는 QtQuick 콘텐츠가 생성되는 동안에는 null이 될 수 있습니다.

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

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

애플리케이션이 사용자 지정 방식으로 OpenGL 컨텍스트 생성 실패와 같은 오류를 처리하려는 경우 이 신호에 연결해야 합니다. 신호에 연결된 슬롯이 없는 경우 동작이 달라집니다: 빠른 실행은 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] void QQuickWidget::setSource(const QUrl &url)

소스를 url 로 설정하고 QML 컴포넌트를 로드하고 인스턴스화합니다.

특히 로컬 파일 시스템에서 파일을 로드할 때는 QUrl::fromLocalFile()를 사용하는 등 제공된 URL이 완전하고 올바른지 확인하세요.

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

source()도 참조하세요 .

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

다시 구현합니다: QWidget::showEvent(QShowEvent * 이벤트).

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 * 이벤트).