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)

Reimplements: (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)

再リンプルメント: (QMouseEvent *event)：QQuickWindow::mousePressEvent(QMouseEvent *event)。

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

再リプルメント: (QMouseEvent *event)：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 が変更されたときに発行されます。