QQuickView Class

Dokumentation der Member-Funktionen

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

Erstellt eine `QQuickView` mit dem angegebenen ` parent`. Der Standardwert von ` parent ` ist 0.

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

Erstellt eine QQuickView mit dem angegebenen QML- engine und dem 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 die engine vor der Ansicht gelöscht wird, gibt status() den Wert „ QQuickView::Error “ zurück.

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

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

Erstellt eine `QQuickView` mit den angegebenen QML- source - und ` parent`-Elementen. Der Standardwert von ` parent ` lautet ` nullptr`.

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

Erstellt eine `QQuickView` mit dem durch ` uri ` und ` typeName ` angegebenen Element sowie 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 den „ QQmlEngine “ zurück, der zur Instanziierung von QML-Komponenten verwendet wird.

QList<QQmlError> QQuickView::errors() const

Gibt die Liste der Fehler zurück, die beim letzten Kompilierungs- oder Erstellungsvorgang aufgetreten sind. Wenn der Status nicht „Fehler“ ist, wird eine leere Liste zurückgegeben.

QSize QQuickView::initialSize() const

Gibt die ursprüngliche Größe des Stammobjekts zurück.

Wenn „ resizeMode “ den Wert „QQuickItem::SizeRootObjectToView“ hat, wird das Stammobjekt auf die Größe der Ansicht angepasst. „initialSize“ enthält die Größe des Stammobjekts vor der Größenanpassung.

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

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

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

Implementiert: ` QQuickWindow::keyReleaseEvent(QKeyEvent *e)`.

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

Lädt die QML-Komponente, die durch uri und typeName identifiziert wird. Wenn die Komponente auf einer QML-Datei basiert, wird source entsprechend gesetzt. Bei Typen, die unter C++ definiert sind, ist source leer.

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

Wird diese Methode mehrmals mit demselben ` uri ` und ` typeName ` aufgerufen, führt dies 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)

Implementiert: ` QQuickWindow::mouseMoveEvent(QMouseEvent *event)`.

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

Implementiert: ` QQuickWindow::mousePressEvent` (`QMouseEvent *event`).

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

Implementiert: ` 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 “ sind für die Übergabe von Daten an QML-Komponenten unerlässlich. In QML sind Kontexte hierarchisch angeordnet, und diese Hierarchie wird vom „ QQmlEngine “ verwaltet.

QQuickItem *QQuickView::rootObject() const

Gibt die Stamm item der Ansicht zurück.

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

Legt die Anfangseigenschaften 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)

Legt die Quelle auf „ url “ fest, lädt die QML-Komponente und instanziiert sie.

Stellen Sie sicher, dass die angegebene URL vollständig und korrekt ist; verwenden Sie insbesondere QUrl::fromLocalFile() beim Laden einer Datei aus dem lokalen Dateisystem.

Wird diese Methode mehrmals mit derselben URL aufgerufen, wird die QML-Komponente erneut instanziiert.

Siehe auch „ source()“.

QUrl QQuickView::source() const

Gibt die Quell-URL zurück, sofern diese festgelegt ist.

Siehe auch „ setSource()“.

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

Dieses Signal wird ausgegeben, wenn sich die aktuelle Eigenschaft „ status “ der Komponente ändert.