QQuickView Class

멤버 함수 문서

[explicit] QQuickView::QQuickView(QWindow *parent = nullptr)

주어진 parent 으로 QQuickView를 구성합니다. parent 의 기본값은 0입니다.

QQuickView::QQuickView(QQmlEngine *engine, QWindow *parent)

주어진 QML engine 과 parent 로 QQuickView를 생성합니다.

참고: 이 경우 QQuickView는 주어진 engine 객체를 소유하지 않으며, 엔진을 파괴하는 것은 호출자의 책임입니다. 보기 전에 engine 이 삭제되면 status() 은 QQuickView::Error 을 반환합니다.

Status, status() 및 errors()도 참조하세요 .

[explicit] QQuickView::QQuickView(const QUrl &source, QWindow *parent = nullptr)

주어진 QML source 과 parent 로 QQuickView를 구축합니다. parent 의 기본값은 nullptr 입니다.

[explicit, since 6.7] QQuickView::QQuickView(QAnyStringView uri, QAnyStringView typeName, QWindow *parent = nullptr)

uri 및 typeName 으로 지정된 요소와 부모 parent 로 QQuickView를 구성합니다. parent 의 기본값은 nullptr 입니다.

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

loadFromModule도 참조하십시오 .

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

QQuickView 를 파괴합니다.

QQmlEngine *QQuickView::engine() const

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

QList<QQmlError> QQuickView::errors() const

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

QSize QQuickView::initialSize() const

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

resizeMode 가 QQuickItem::SizeRootObjectToView인 경우 루트 개체의 크기가 뷰의 크기로 조정됩니다. 초기 크기에는 크기가 조정되기 전의 루트 개체의 크기가 포함됩니다.

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

다시 구현합니다: QQuickWindow::keyPressEvent(QKeyEvent *e).

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

다시 구현합니다: QQuickWindow::keyReleaseEvent(QKeyEvent *e).

[slot, since 6.7] void QQuickView::loadFromModule(QAnyStringView uri, QAnyStringView typeName)

uri 및 typeName 으로 식별되는 QML 컴포넌트를 로드합니다. 컴포넌트가 QML 파일로 뒷받침되는 경우 source 이 적절하게 설정됩니다. C++ 에 정의된 유형의 경우 source 은 비어 있습니다.

이 메서드가 호출되기 전에 source 이 설정되어 있으면 지워집니다.

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

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

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

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

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

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

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

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

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

QQmlContext *QQuickView::rootContext() const

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

QQuickItem *QQuickView::rootObject() const

뷰의 루트를 반환합니다 item.

[slot] void QQuickView::setInitialProperties(const QVariantMap &initialProperties)

QQuickView::setSource()을 호출한 후 QML 컴포넌트가 초기화되는 초기 속성 initialProperties 을 설정합니다.

    QScopedPointer<QQuickView> view { new QQuickView };
    view->setInitialProperties({"x, 100"}, {"width", 50});
    view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
    view->show();

QQmlComponent::createWithInitialProperties()도 참조하세요 .

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

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

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

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

source()도 참조하세요 .

QUrl QQuickView::source() const

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

setSource()도 참조하세요 .

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

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