QQuickWidget Class

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

Dokumentation der Member-Funktionen

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

Erstellt ein QQuickWidget mit einer Standard-QML-Engine als untergeordnetes Element von „ parent “.

Der Standardwert von ` parent ` ist ` nullptr`.

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

Erstellt ein QQuickWidget mit dem angegebenen QML- engine als untergeordnetes Element von parent.

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

Erstellt ein QQuickWidget mit einer Standard-QML-Engine und der angegebenen QML- source als untergeordnetes Element von parent.

Der Standardwert von ` parent ` ist ` nullptr`.

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

Erstellt ein QQuickWidget mit dem durch uri und typeName angegebenen Element und dem übergeordneten Element parent. Der Standardwert von parent ist nullptr.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch loadFromModule.

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

Zerstört die „ QQuickWidget “.

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

Umsetzt: ` QWidget::dragEnterEvent` (`QDragEnterEvent *event`).

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

Umsetzt: ` QWidget::dragLeaveEvent` (`QDragLeaveEvent *event`).

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

Umsetzt: QWidget::dragMoveEvent(QDragMoveEvent *event).

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

Implementiert: ` QWidget::dropEvent(QDropEvent *event)`.

QQmlEngine *QQuickWidget::engine() const

Gibt einen Zeiger auf den „ QQmlEngine “ zurück, der zur Instanziierung von QML-Komponenten verwendet wird.

QList<QQmlError> QQuickWidget::errors() const

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

Siehe auch „ status “.

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

Umsetzt: ` QWidget::event(QEvent *event)`.

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

Implementiert: ` QWidget::focusInEvent(QFocusEvent *event)`.

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

Implementiert: ` QWidget::focusNextPrevChild` (bool next).

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

Implementiert: QWidget::focusOutEvent(QFocusEvent *event).

QSurfaceFormat QQuickWidget::format() const

Gibt das tatsächliche Oberflächenformat zurück.

Wenn das Widget noch nicht angezeigt wurde, wird das angeforderte Format zurückgegeben.

Siehe auch ` setFormat()`.

QImage QQuickWidget::grabFramebuffer() const

Rendert ein Bild und liest es wieder in ein Bild ein.

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

Implementiert: ` QWidget::hideEvent(QHideEvent *event)`.

QSize QQuickWidget::initialSize() const

Gibt die ursprüngliche Größe des Root-Objekts zurück.

Wenn „ resizeMode “ auf „ SizeRootObjectToView “ gesetzt ist, wird das Stammobjekt auf die Größe der Ansicht angepasst. Diese Funktion gibt die Größe des Stammobjekts vor der Größenanpassung zurück.

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

Implementiert: ` QWidget::keyPressEvent(QKeyEvent *event)`.

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

Implementiert: ` QWidget::keyReleaseEvent(QKeyEvent *event)`.

[slot, since 6.9] void QQuickWidget::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 in 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 denselben Werten für ` uri ` und ` typeName ` aufgerufen, wird die QML-Komponente neu instanziiert.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch „ setSource “, „ QQmlComponent::loadFromModule “ und „ QQmlApplicationEngine::loadFromModule “.

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

Implementiert: ` QWidget::mouseDoubleClickEvent(QMouseEvent *event)`.

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

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

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

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

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

Implementiert: ` QWidget::mouseReleaseEvent` (`QMouseEvent *event`).

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

Umsetzt: ` QWidget::paintEvent` (`QPaintEvent *event`).

QQuickWindow *QQuickWidget::quickWindow() const

Gibt das Offscreen- QQuickWindow zurück, das von diesem Widget zur Steuerung der Darstellung von Qt Quick verwendet wird. Dies ist nützlich, wenn Sie QQuickWindow -APIs nutzen möchten, die derzeit nicht von QQuickWidget bereitgestellt werden, beispielsweise um eine Verbindung zum Signal QQuickWindow::beforeRendering() herzustellen, um native OpenGL-Inhalte unterhalb der eigenen Darstellung von Qt Quick zu zeichnen.

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

Gibt das Stamm- item der Ansicht zurück. Kann den Wert „ nullptr “ annehmen, wenn „ setSource()“ nicht aufgerufen wurde, wenn es mit fehlerhaftem „ QtQuick “-Code aufgerufen wurde oder wenn das Stamm-Item aus anderen Gründen undefiniert ist.

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

Dieses Signal wird ausgegeben, wenn während der Initialisierung des Szenengraphen ein „ error “ aufgetreten ist.

Anwendungen sollten sich an dieses Signal anschließen, wenn sie Fehler, wie z. B. Fehler bei der Erstellung des OpenGL-Kontexts, auf eigene Weise behandeln möchten. Wenn kein Slot an das Signal angeschlossen ist, verhält sich das Programm anders: Quick gibt die „ message “ aus oder zeigt ein Meldungsfeld an und beendet die Anwendung.

Dieses Signal wird vom GUI-Thread ausgelöst.

Siehe auch ` QQuickWindow::sceneGraphError()`.

void QQuickWidget::setClearColor(const QColor &color)

Legt die Farbe „clear“ fest: color. Standardmäßig ist dies eine undurchsichtige Farbe.

Um eine halbtransparente „ QQuickWidget “ zu erhalten, rufen Sie diese Funktion auf, wobei „ color “ auf „ Qt::transparent “ gesetzt ist, legen Sie das Widget-Attribut „ Qt::WA_TranslucentBackground “ im obersten Fenster fest und fordern Sie einen Alphakanal über „ setFormat()“ an.

Siehe auch QQuickWindow::setColor().

void QQuickWidget::setFormat(const QSurfaceFormat &format)

Legt die Oberflächen format en für den Kontext und die Offscreen-Oberfläche fest, die von diesem Widget verwendet werden.

Rufen Sie diese Funktion auf, wenn ein Kontext für eine bestimmte OpenGL-Version oder ein bestimmtes Profil angefordert werden soll. Die Größen für Tiefen-, Stencil- und Alpha-Puffer werden automatisch berücksichtigt und müssen nicht explizit angefordert werden.

Siehe auch „ QWindow::setFormat()“, „ QWindow::format()“ und „ format()“.

[slot, since 6.9] void QQuickWidget::setInitialProperties(const QVariantMap &initialProperties)

Legt die Anfangseigenschaften „ initialProperties “ fest, mit denen die QML-Komponente nach dem Aufruf von „ QQuickWidget::setSource()“ initialisiert wird.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch ` QQmlComponent::createWithInitialProperties()`.

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

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

Implementiert: ` QWidget::showEvent(QShowEvent *event)`.

QUrl QQuickWidget::source() const

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

Siehe auch „ setSource()“.

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

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

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

Implementiert: ` QWidget::wheelEvent` (`QWheelEvent *event`).