QQuickView Class

メンバ関数ドキュメント

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

与えられたparent で QQuickView を構築します。parent のデフォルト値は 0 です。

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

与えられたQMLengine とparent を用いてQQuickViewを構築します。

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

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

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

与えられた QMLsource と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 コンポーネントをロードしてインスタンス化します。

特に、ローカルファイルシステムからファイルを読み込む場合はQUrl::fromLocalFile() を使用してください。

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

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

QUrl QQuickView::source() const

設定されていれば、ソース URL を返す。

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

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

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