QQuickView Class

Mitgliederfunktion Dokumentation

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

Konstruiert eine QQuickView mit der angegebenen parent. Der Standardwert von parent ist 0.

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

Konstruiert eine QQuickView mit der angegebenen QML engine und parent.

Hinweis: In diesem Fall besitzt die QQuickView das angegebene engine Objekt nicht; es liegt in der Verantwortung des Aufrufers, die Engine zu zerstören. Wenn engine vor der Ansicht gelöscht wird, gibt status() QQuickView::Error zurück.

Siehe auch Status, status(), und errors().

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

Konstruiert eine QQuickView mit der angegebenen QML source und parent. Der Standardwert von parent ist nullptr.

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

Konstruiert eine QQuickView mit dem durch uri und typeName angegebenen Element und dem übergeordneten Element parent. Der Standardwert von parent ist nullptr.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch loadFromModule.

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

Zerstört die QQuickView.

QQmlEngine *QQuickView::engine() const

Gibt einen Zeiger auf die QQmlEngine zurück, die für die Instanzierung von QML-Komponenten verwendet wird.

QList<QQmlError> QQuickView::errors() const

Gibt die Liste der Fehler zurück, die während des letzten Kompilier- oder Erstellungsvorgangs aufgetreten sind. Wenn der Status nicht Error ist, wird eine leere Liste zurückgegeben.

QSize QQuickView::initialSize() const

Gibt die Anfangsgröße des Stammobjekts zurück.

Wenn resizeMode QQuickItem::SizeRootObjectToView ist, wird die Größe des Stammobjekts an die Größe der Ansicht angepasst. initialSize enthält die Größe des Stammobjekts vor der Größenänderung.

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

Reimplements: QQuickWindow::keyPressEvent(QKeyEvent *e).

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

Reimplements: QQuickWindow::keyReleaseEvent(QKeyEvent *e).

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

Lädt die durch uri und typeName identifizierte QML-Komponente. Wenn die Komponente durch eine QML-Datei unterstützt wird, wird source entsprechend gesetzt. Bei Typen, die in C++ definiert sind, ist source leer.

Falls source vor dem Aufruf dieser Methode gesetzt wurde, wird es gelöscht.

Ein mehrfacher Aufruf dieser Methode mit denselben uri und typeName führt dazu, dass die QML-Komponente neu instanziiert wird.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch setSource, QQmlComponent::loadFromModule, und QQmlApplicationEngine::loadFromModule.

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

Reimplements: QQuickWindow::mouseMoveEvent(QMouseEvent *event).

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

Reimplements: QQuickWindow::mousePressEvent(QMouseEvent *event).

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

Reimplements: QQuickWindow::mouseReleaseEvent(QMouseEvent *event).

QQmlContext *QQuickView::rootContext() const

Diese Funktion gibt die Wurzel der Kontexthierarchie zurück. Jede QML-Komponente wird in einem QQmlContext instanziiert. QQmlContext ist für die Übergabe von Daten an QML-Komponenten unerlässlich. In QML sind die Kontexte hierarchisch angeordnet, und diese Hierarchie wird von QQmlEngine verwaltet.

QQuickItem *QQuickView::rootObject() const

Gibt die Wurzel der Ansicht item zurück.

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

Legt die anfänglichen Eigenschaften initialProperties fest, mit denen die QML-Komponente nach dem Aufruf von QQuickView::setSource() initialisiert wird.

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

Siehe auch QQmlComponent::createWithInitialProperties().

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

Setzt die Quelle auf url, lädt die QML-Komponente und instanziiert sie.

Achten Sie darauf, dass die angegebene URL vollständig und korrekt ist. Verwenden Sie insbesondere QUrl::fromLocalFile(), wenn Sie eine Datei aus dem lokalen Dateisystem laden.

Ein mehrfacher Aufruf dieser Methode mit der gleichen URL führt dazu, dass die QML-Komponente neu instanziiert wird.

Siehe auch source().

QUrl QQuickView::source() const

Gibt die Quell-URL zurück, falls gesetzt.

Siehe auch setSource().

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

Dieses Signal wird ausgesendet, wenn sich die aktuelle status der Komponente ändert.