QQuickWidget Class

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

Fonction membre Documentation

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

Construit un QQuickWidget avec 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)

Construit un QQuickWidget avec l'objet QML engine donné comme enfant de parent.

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

Construit un QQuickWidget avec un moteur QML par défaut et le QML source donné comme 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)

Construit 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 aussi loadFromModule.

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

Détruit le site 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 sur le site 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. Si 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 actuel de la surface.

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

Voir également setFormat().

QImage QQuickWidget::grabFramebuffer() const

Effectue le rendu d'une trame et la relit dans une 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é à la taille de la vue. Cette fonction renvoie la taille de l'objet racine avant qu'il ne soit redimensionné.

[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 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.9.

Voir aussi 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 le hors-écran QQuickWindow qui est utilisé par ce widget pour piloter le rendu Qt Quick. Ceci est utile si vous voulez utiliser les API QQuickWindow qui ne sont pas actuellement exposées par QQuickWidget, par exemple en vous connectant au signal QQuickWindow::beforeRendering() afin de dessiner du contenu OpenGL natif sous le propre rendu de Qt Quick.

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

Renvoie la racine de la vue item. Peut être nullptr si setSource() n'a pas été appelé, s'il a été appelé avec un code QtQuick erroné ou si l'élément racine est autrement indéfini.

[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 devraient se connecter à ce signal si elles souhaitent gérer les erreurs, comme les échecs de création de contexte OpenGL, d'une manière personnalisée. Si aucun slot n'est connecté au signal, le comportement sera différent : Quick imprimera le message message, ou affichera une boîte de message, et mettra fin à l'application.

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

Voir aussi QQuickWindow::sceneGraphError().

void QQuickWidget::setClearColor(const QColor &color)

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

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

Voir également QQuickWindow::setColor().

void QQuickWidget::setFormat(const QSurfaceFormat &format)

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

Cette fonction est appelée 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 prises en charge automatiquement et il n'est pas nécessaire de les demander explicitement.

Voir aussi 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 avoir appelé QQuickWidget::setSource().

Cette fonction a été introduite dans Qt 6.9.

Voir aussi QQmlComponent::createWithInitialProperties().

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

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

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

QUrl QQuickWidget::source() const

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

Voir également setSource().

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

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

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

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