QQuickView Class

Documentation des fonctions membres

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

Crée un objet `QQuickView` avec l'parent` spécifié. La valeur par défaut de ` parent ` est 0.

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

Crée un QQuickView à partir de l'engine et de l'parent fournis au format QML.

Remarque : dans ce cas, le QQuickView ne détient pas la propriété de l’objet « engine » fourni ; il incombe à l’appelant de détruire le moteur. Si l’objet « engine » est supprimé avant la vue, la fonction « status() » renverra « QQuickView::Error ».

Voir également Status, status() et errors().

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

Crée un objet QQuickView à partir des éléments QML fournis : ` source ` et ` parent`. La valeur par défaut de ` parent ` est ` nullptr`.

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

Crée un objet `QQuickView` avec l'élément spécifié par ` uri ` et ` typeName `, et dont le parent est ` parent`. La valeur par défaut de ` parent ` est ` nullptr`.

Cette fonction a été introduite dans Qt 6.7.

Voir également loadFromModule.

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

Supprime l'QQuickView.

QQmlEngine *QQuickView::engine() const

Renvoie un pointeur vers l'QQmlEngine utilisé pour l'instanciation des composants QML.

QList<QQmlError> QQuickView::errors() const

Renvoie la liste des erreurs survenues lors de la dernière opération de compilation ou de création. Lorsque le statut n'est pas « Error », une liste vide est renvoyée.

QSize QQuickView::initialSize() const

Renvoie la taille initiale de l'objet racine.

Si la valeur de ` resizeMode ` est `QQuickItem::SizeRootObjectToView`, l'objet racine sera redimensionné pour s'adapter à la taille de la vue. `initialSize` contient la taille de l'objet racine avant son redimensionnement.

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

Réimplémente : QQuickWindow::keyPressEvent(QKeyEvent *e).

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

Réimplémente : QQuickWindow::keyReleaseEvent(QKeyEvent *e).

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

Charge le composant QML identifié par uri et typeName. Si le composant est associé à un fichier QML, source sera défini en conséquence. Pour les types définis dans C++, source sera vide.

Si une valeur source avait été définie avant l'appel de cette méthode, elle sera effacée.

L'appel répété de cette méthode avec les mêmes paramètres uri et typeName entraînera la réinstanciation du composant QML.

Cette fonction a été introduite dans Qt 6.7.

Voir également ` setSource`, ` QQmlComponent::loadFromModule` et ` QQmlApplicationEngine::loadFromModule`.

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

Réimplémente : QQuickWindow::mouseMoveEvent(QMouseEvent *event).

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

Réimplémente : QQuickWindow::mousePressEvent(QMouseEvent *event).

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

Réimplémente : QQuickWindow::mouseReleaseEvent(QMouseEvent *event).

QQmlContext *QQuickView::rootContext() const

Cette fonction renvoie la racine de la hiérarchie de contextes. Chaque composant QML est instancié dans un ` QQmlContext`. Les ` QQmlContext` sont indispensables pour transmettre des données aux composants QML. En QML, les contextes sont organisés de manière hiérarchique et cette hiérarchie est gérée par l'` QQmlEngine`.

QQuickItem *QQuickView::rootObject() const

Renvoie l'item racine de la vue.

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

Définit les propriétés initiales initialProperties avec lesquelles le composant QML est initialisé après l'appel de la fonction QQuickView::setSource().

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

Voir également QQmlComponent::createWithInitialProperties().

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

Définit la source sur url, charge le composant QML et l'instancie.

Assurez-vous que l'URL fournie est complète et correcte ; en particulier, utilisez QUrl::fromLocalFile() lorsque vous chargez un fichier à partir du système de fichiers local.

Appeler cette méthode plusieurs fois avec la même URL entraînera la réinstanciation du composant QML.

Voir également source().

QUrl QQuickView::source() const

Renvoie l'URL source, si elle est définie.

Voir également setSource().

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

Ce signal est émis lorsque l'status actuelle du composant change.