QQuickView Class

Fonction membre Documentation

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

Construit un QQuickView avec la valeur donnée parent. La valeur par défaut de parent est 0.

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

Construit un QQuickView avec les objets QML engine et parent.

Remarque : dans ce cas, le QQuickView ne possède pas l'objet engine donné ; il incombe à l'appelant de détruire le moteur. Si l'objet engine est supprimé avant la vue, status() renverra QQuickView::Error.

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

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

Construit un QQuickView avec les QML donnés 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)

Construit un QQuickView avec l'élément spécifié par uri et typeName et le parent parent. La valeur par défaut de parent est nullptr.

Cette fonction a été introduite dans Qt 6.7.

Voir aussi loadFromModule.

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

Détruit le site QQuickView.

QQmlEngine *QQuickView::engine() const

Renvoie un pointeur sur le site 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. Si 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 resizeMode est QQuickItem::SizeRootObjectToView, l'objet racine sera redimensionné à la taille de la vue. initialSize contient la taille de l'objet racine avant qu'il ne soit redimensionné.

[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 soutenu par un fichier QML, source sera défini en conséquence. Pour les types définis dans C++, source sera vide.

Si source a été défini avant l'appel de cette méthode, il sera effacé.

Si vous appelez cette méthode plusieurs fois avec les mêmes uri et typeName, le composant QML sera réinstancié.

Cette fonction a été introduite dans Qt 6.7.

Voir aussi 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 du contexte. Chaque composant QML est instancié dans un contexte QQmlContext. Les contextes QQmlContext sont essentiels 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 QQmlEngine.

QQuickItem *QQuickView::rootObject() const

Renvoie la racine de la vue item.

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

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

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

Voir aussi QQmlComponent::createWithInitialProperties().

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

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

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

Si vous appelez cette méthode plusieurs fois avec la même URL, le composant QML sera réinstancié.

Voir également source().

QUrl QQuickView::source() const

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

Voir également setSource().

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

Ce signal est émis lorsque l'adresse status du composant est modifiée.