QQuickWidget Class

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

メンバ関数のドキュメント

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

parent の子要素として、デフォルトのQMLエンジンを備えたQQuickWidgetを作成します。

parent のデフォルト値はnullptr です。

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

指定されたQMLのengine をparent の子要素として持つQQuickWidgetを構築します。

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

デフォルトのQMLエンジンと、指定されたQMLsource を持つQQuickWidgetを、parent の子として生成します。

parent のデフォルト値はnullptr です。

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

uri およびtypeName で指定された要素と、親要素parent を持つ QQuickWidget を生成します。parent のデフォルト値はnullptr です。

この関数は Qt 6.9 で導入されました。

loadFromModuleも参照してください 。

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

QQuickWidget を削除します。

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

QWidget::dragEnterEvent （QDragEnterEvent *event）を再実装します。

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

QWidget::dragLeaveEvent(QDragLeaveEvent *event) を再実装します。

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

QWidget::dragMoveEvent(QDragMoveEvent *event) を再実装します。

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

QWidget::dropEvent （QDropEvent *event）を再実装しています。

QQmlEngine *QQuickWidget::engine() const

QMLコンポーネントのインスタンス化に使用されるQQmlEngine へのポインタを返します。

QList<QQmlError> QQuickWidget::errors() const

前回のコンパイルまたは作成操作中に発生したエラーのリストを返します。ステータスがError でない場合は、空のリストが返されます。

「status」も参照してください 。

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

QWidget::event(QEvent *event) を再実装します。

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

QWidget::focusInEvent(QFocusEvent *event) を再実装します。

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

QWidget::focusNextPrevChild （bool next）を再実装します。

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

QWidget::focusOutEvent （QFocusEvent *event）を再実装します。

QSurfaceFormat QQuickWidget::format() const

実際のサーフェス形式を返します。

ウィジェットがまだ表示されていない場合、指定されたフォーマットが返されます。

setFormat()も参照してください 。

QImage QQuickWidget::grabFramebuffer() const

フレームをレンダリングし、それを画像として読み込みます。

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

QWidget::hideEvent(QHideEvent *event) を再実装します。

QSize QQuickWidget::initialSize() const

ルートオブジェクトの初期サイズを返します。

resizeMode がSizeRootObjectToView の場合、ルートオブジェクトはビューのサイズに合わせてリサイズされます。この関数は、リサイズされる前のルートオブジェクトのサイズを返します。

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

QWidget::keyPressEvent(QKeyEvent *event) を再実装します。

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

QWidget::keyReleaseEvent(QKeyEvent *event) を再実装します。

[slot, since 6.9] void QQuickWidget::loadFromModule(QAnyStringView uri, QAnyStringView typeName)

uri およびtypeName で指定された QML コンポーネントを読み込みます。コンポーネントが QML ファイルに基づいている場合、source はそれに応じて設定されます。C++ で定義された型の場合、source は空になります。

このメソッドが呼び出される前にsource が設定されていた場合、その値はクリアされます。

同じuri およびtypeName を指定してこのメソッドを複数回呼び出すと、QML コンポーネントが再インスタンス化されます。

この関数は Qt 6.9 で導入されました。

setSource 、QQmlComponent::loadFromModule 、およびQQmlApplicationEngine::loadFromModuleも参照してください 。

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

QWidget::mouseDoubleClickEvent(QMouseEvent *event) を再実装しています。

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

QWidget::mouseMoveEvent(QMouseEvent *event) を再実装します。

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

QWidget::mousePressEvent(QMouseEvent *event) の再実装です。

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

QWidget::mouseReleaseEvent(QMouseEvent *event) を再実装します。

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

QWidget::paintEvent （QPaintEvent *event）を再実装します。

QQuickWindow *QQuickWidget::quickWindow() const

このウィジェットがQt Quick のレンダリングを制御するために使用する、オフスクリーンのQQuickWindow を返します。これは、QQuickWidget で現在公開されていないQQuickWindow APIを使用したい場合に役立ちます。例えば、Qt Quick 自身のレンダリングの下にネイティブなOpenGLコンテンツを描画するために、QQuickWindow::beforeRendering()シグナルに接続する場合などが挙げられます。

QQmlContext *QQuickWidget::rootContext() const

この関数は、コンテキスト階層のルート返します。各QMLコンポーネントは、QQmlContext 内でインスタンス化されます。QQmlContext は、QMLコンポーネントにデータを渡すために不可欠です。QMLでは、コンテキストは階層的に配置されており、この階層はQQmlEngine によって管理されています。

QQuickItem *QQuickWidget::rootObject() const

ビューのルートitem を返します。setSource()が呼び出されていない場合、QtQuick のコードに不具合がある状態で呼び出された場合、またはルートアイテムが何らかの理由で未定義である場合、nullptr が返されることがあります。

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

このシグナルは、シーングラフの初期化中にerror が発生した際に発火します。

OpenGLコンテキストの作成失敗などのエラーを独自の方法で処理したい場合は、アプリケーションはこのシグナルに接続する必要があります。このシグナルにスロットが接続されていない場合、動作は異なります。Quickはmessage を出力するか、メッセージボックスを表示し、アプリケーションを終了します。

このシグナルはGUIスレッドから発信されます。

QQuickWindow::sceneGraphError()も参照してください 。

void QQuickWidget::setClearColor(const QColor &color)

color を透明に設定します。デフォルトでは不透明な色になります。

半透明のQQuickWidget を取得するには、color をQt::transparent に設定してこの関数を呼び出し、最上位ウィンドウのQt::WA_TranslucentBackground ウィジェット属性を設定し、setFormat()を介してアルファチャンネルを要求します。

QQuickWindow::setColor()も参照してください 。

void QQuickWidget::setFormat(const QSurfaceFormat &format)

このウィジェットで使用されるコンテキストおよびオフスクリーンサーフェスのサーフェスformat を設定します。

特定の OpenGL バージョンまたはプロファイルのコンテキストを要求する必要がある場合は、この関数を呼び出してください。深度バッファ、ステンシルバッファ、アルファバッファのサイズは自動的に処理されるため、それらを明示的に要求する必要はありません。

QWindow::setFormat()、QWindow::format()、およびformat()も参照してください 。

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

QQuickWidget::setSource() を呼び出した後に、QML コンポーネントが初期化される際の初期プロパティinitialProperties を設定します。

この関数は Qt 6.9 で導入されました。

「QQmlComponent::createWithInitialProperties()」も参照してください 。

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

ソースをurl に設定し、QML コンポーネントを読み込んでインスタンス化します。

指定するURLが完全かつ正確であることを確認してください。特に、ローカルファイルシステムからファイルをロードする際は、QUrl::fromLocalFile() を使用してください。

同じ URL でこのメソッドを複数回呼び出すと、QML コンポーネントが再インスタンス化されます。

source()も参照してください 。

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

QWidget::showEvent(QShowEvent *event) を再実装します。

QUrl QQuickWidget::source() const

設定されている場合、ソースURLを返します。

関連項目： setSource()。

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

このシグナルは、コンポーネントの現在のstatus が変更されたときに発信されます。

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

QWidget::wheelEvent(QWheelEvent *event) の再実装です。