QQuickView Class

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

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

指定されたparent を使用してQQuickViewを構築します。parent のデフォルト値は0です。

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

指定されたQMLのengine およびparent を使用して、QQuickViewを構築します。

注：この場合、QQuickViewは指定されたengine オブジェクトを所有しません。エンジンの破棄は呼び出し側の責任となります。engine がビューより先に削除された場合、status()はQQuickView::Error を返します。

Status 、status()、およびerrors()も参照してください 。

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

指定されたQMLのsource およびparent を使用して、QQuickViewを生成します。parent のデフォルト値はnullptr です。

[explicit, since 6.7] QQuickView::QQuickView(QAnyStringView uri, QAnyStringView typeName, QWindow *parent = nullptr)

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

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

loadFromModuleも参照してください 。

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

QQuickView を削除します。

QQmlEngine *QQuickView::engine() const

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

QList<QQmlError> QQuickView::errors() const

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

QSize QQuickView::initialSize() const

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

resizeMode がQQuickItem::SizeRootObjectToViewの場合、ルートオブジェクトはビューのサイズに合わせてリサイズされます。initialSizeには、リサイズされる前のルートオブジェクトのサイズが格納されます。

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

QQuickWindow::keyPressEvent(QKeyEvent *e) を再実装します。

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

QQuickWindow::keyReleaseEvent(QKeyEvent *e) を再実装します。

[slot, since 6.7] void QQuickView::loadFromModule(QAnyStringView uri, QAnyStringView typeName)

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

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

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

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

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

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

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

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

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

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

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

QQmlContext *QQuickView::rootContext() const

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

QQuickItem *QQuickView::rootObject() const

ビューのルートであるitem を返します。

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

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

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

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

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

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

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

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

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

QUrl QQuickView::source() const

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

関連項目： setSource()。

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

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