QQuickWidget Class

QQuickWidget *view = new QQuickWidget;
view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
view->show();

Documentation des fonctions membres

[explicit] QQuickWidget::QQuickWidget(QWidget *parent = nullptr)

Crée un QQuickWidget doté d'un moteur QML par défaut, en tant qu'enfant de parent.

La valeur par défaut de ` parent ` est ` nullptr`.

QQuickWidget::QQuickWidget(QQmlEngine *engine, QWidget *parent)

Crée un QQuickWidget avec l'engine QML spécifié en tant qu'enfant de parent.

[explicit] QQuickWidget::QQuickWidget(const QUrl &source, QWidget *parent = nullptr)

Crée un QQuickWidget avec un moteur QML par défaut et l'source QML spécifiée, en tant qu'enfant de parent.

La valeur par défaut de ` parent ` est ` nullptr`.

[explicit, since 6.9] QQuickWidget::QQuickWidget(QAnyStringView uri, QAnyStringView typeName, QWidget *parent = nullptr)

Crée un QQuickWidget 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.9.

Voir également loadFromModule.

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

Supprime l'QQuickWidget.

[override virtual protected] void QQuickWidget::dragEnterEvent(QDragEnterEvent *e)

Réimplémente : QWidget::dragEnterEvent(QDragEnterEvent *event).

[override virtual protected] void QQuickWidget::dragLeaveEvent(QDragLeaveEvent *e)

Réimplémente : QWidget::dragLeaveEvent(QDragLeaveEvent *event).

[override virtual protected] void QQuickWidget::dragMoveEvent(QDragMoveEvent *e)

Réimplémente : QWidget::dragMoveEvent(QDragMoveEvent *event).

[override virtual protected] void QQuickWidget::dropEvent(QDropEvent *e)

Réimplémente : QWidget::dropEvent(QDropEvent *event).

QQmlEngine *QQuickWidget::engine() const

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

QList<QQmlError> QQuickWidget::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.

Voir également status.

[override virtual protected] bool QQuickWidget::event(QEvent *e)

Réimplémente : QWidget::event(QEvent *event).

[override virtual protected] void QQuickWidget::focusInEvent(QFocusEvent *event)

Réimplémente : QWidget::focusInEvent(QFocusEvent *event).

[override virtual protected] bool QQuickWidget::focusNextPrevChild(bool next)

Réimplémente : QWidget::focusNextPrevChild(bool next).

[override virtual protected] void QQuickWidget::focusOutEvent(QFocusEvent *event)

Réimplémente : QWidget::focusOutEvent(QFocusEvent *event).

QSurfaceFormat QQuickWidget::format() const

Renvoie le format réel de la surface.

Si le widget n'a pas encore été affiché, le format demandé est renvoyé.

Voir également setFormat().

QImage QQuickWidget::grabFramebuffer() const

Affiche une image et la réimporte dans un fichier image.

[override virtual protected] void QQuickWidget::hideEvent(QHideEvent *)

Réimplémente : QWidget::hideEvent(QHideEvent *event).

QSize QQuickWidget::initialSize() const

Renvoie la taille initiale de l'objet racine.

Si resizeMode est SizeRootObjectToView, l'objet racine sera redimensionné pour s'adapter à la taille de la vue. Cette fonction renvoie la taille de l'objet racine avant son redimensionnement.

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

Réimplémente : QWidget::keyPressEvent(QKeyEvent *event).

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

Réimplémente : QWidget::keyReleaseEvent(QKeyEvent *event).

[slot, since 6.9] void QQuickWidget::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 uri et typeName entraînera la réinstanciation du composant QML.

Cette fonction a été introduite dans Qt 6.9.

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

[override virtual protected] void QQuickWidget::mouseDoubleClickEvent(QMouseEvent *e)

Réimplémente : QWidget::mouseDoubleClickEvent(QMouseEvent *event).

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

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

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

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

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

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

[override virtual protected] void QQuickWidget::paintEvent(QPaintEvent *event)

Réimplémente : QWidget::paintEvent(QPaintEvent *event).

QQuickWindow *QQuickWidget::quickWindow() const

Renvoie l'QQuickWindow hors écran utilisé par ce widget pour piloter le rendu de Qt Quick. Cela s'avère utile si vous souhaitez utiliser des API QQuickWindow qui ne sont pas actuellement exposées par QQuickWidget, par exemple pour vous connecter au signal QQuickWindow::beforeRendering() afin de dessiner du contenu OpenGL natif sous le rendu propre à Qt Quick.

QQmlContext *QQuickWidget::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 *QQuickWidget::rootObject() const

Renvoie l'item de la racine de la vue. Peut prendre la valeur « nullptr » lorsque la fonction setSource() n'a pas été appelée, si celle-ci a été appelée avec un code QtQuick défectueux ou si l'élément racine n'est pas défini pour une autre raison.

[signal] void QQuickWidget::sceneGraphError(QQuickWindow::SceneGraphError error, const QString &message)

Ce signal est émis lorsqu'une erreur « error » s'est produite lors de l'initialisation du graphe de scène.

Les applications doivent se connecter à ce signal si elles souhaitent gérer les erreurs, telles que les échecs de création de contexte OpenGL, de manière personnalisée. Lorsqu’aucun slot n’est connecté au signal, le comportement sera différent : Quick affichera l’ message, ou fera apparaître une boîte de message, puis mettra fin à l’application.

Ce signal sera émis depuis le thread de l'interface graphique.

Voir également ` QQuickWindow::sceneGraphError()` ().

void QQuickWidget::setClearColor(const QColor &color)

Définit la couleur « clear » color. Par défaut, il s'agit d'une couleur opaque.

Pour obtenir une QQuickWidget semi-transparente, appelez cette fonction en définissant color sur Qt::transparent, définissez l'attribut Qt::WA_TranslucentBackground du widget sur la fenêtre de niveau supérieur, puis demandez un canal alpha via setFormat().

Voir également QQuickWindow::setColor().

void QQuickWidget::setFormat(const QSurfaceFormat &format)

Définit l'format de surface pour le contexte et la surface hors écran utilisés par ce widget.

Appelez cette fonction lorsqu'il est nécessaire de demander un contexte pour une version ou un profil OpenGL donné. Les tailles des tampons de profondeur, de stencil et d'alpha sont gérées automatiquement ; il n'est donc pas nécessaire de les demander explicitement.

Voir également ` QWindow::setFormat()`, ` QWindow::format()` et ` format()`.

[slot, since 6.9] void QQuickWidget::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 QQuickWidget::setSource().

Cette fonction a été introduite dans Qt 6.9.

Voir également ` QQmlComponent::createWithInitialProperties()`.

[slot] void QQuickWidget::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 aussi source().

[override virtual protected] void QQuickWidget::showEvent(QShowEvent *)

Réimplémente : QWidget::showEvent(QShowEvent *event).

QUrl QQuickWidget::source() const

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

Voir aussi setSource().

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

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

[override virtual protected] void QQuickWidget::wheelEvent(QWheelEvent *e)

Réimplémente : QWidget::wheelEvent(QWheelEvent *event).