QQmlComponent Class

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

QQmlComponent::QQmlComponent(QQmlEngine *engine, QObject *parent = nullptr)

データのない QQmlComponent を作成し、指定されたengine とparent を与えます。setData() でデータを設定します。

QQmlComponent::QQmlComponent(QQmlEngine *engine, const QString &fileName, QObject *parent = nullptr)

与えられたfileName から QQmlComponent を作成し、指定されたparent とengine を与えます。

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

QQmlComponent::QQmlComponent(QQmlEngine *engine, const QUrl &url, QObject *parent = nullptr)

与えられたurl から QQmlComponent を作成し、指定されたparent とengine を与えます。

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

相対パスは、QQmlEngine::baseUrl() に対して解決される。 () は、指定がない限り、現在の作業ディレクトリである。

loadUrl()も参照 。

QQmlComponent::QQmlComponent(QQmlEngine *engine, const QString &fileName, QQmlComponent::CompilationMode mode, QObject *parent = nullptr)

与えられたfileName から QQmlComponent を作成し、指定されたparent とengine を与えます。mode がAsynchronous の場合、コンポーネントは非同期にロードされ、コンパイルされます。

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

QQmlComponent::QQmlComponent(QQmlEngine *engine, const QUrl &url, QQmlComponent::CompilationMode mode, QObject *parent = nullptr)

与えられたurl から QQmlComponent を作成し、指定されたparent とengine を与えます。mode がAsynchronous の場合、コンポーネントは非同期にロードされ、コンパイルされます。

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

相対パスは、QQmlEngine::baseUrl() に対して解決されます。 () は、指定がない限り、現在の作業ディレクトリです。

loadUrl()も参照のこと 。

[explicit, since 6.5] QQmlComponent::QQmlComponent(QQmlEngine *engine, QAnyStringView uri, QAnyStringView typeName, QObject *parent = nullptr)

与えられたuri とtypeName から QQmlComponent を作成し、指定されたparent とengine を与えます。 可能であれば、コンポーネントは同期的にロードされます。

これはオーバーロードされた関数です。

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

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

[explicit, since 6.5] QQmlComponent::QQmlComponent(QQmlEngine *engine, QAnyStringView uri, QAnyStringView typeName, QQmlComponent::CompilationMode mode, QObject *parent = nullptr)

与えられたuri とtypeName から QQmlComponent を作成し、指定されたparent とengine を与えます。mode がAsynchronous の場合、コンポーネントは非同期にロードされ、コンパイルされます。

これはオーバーロードされた関数です。

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

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

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

QQmlComponent を破壊する。

[virtual] QObject *QQmlComponent::beginCreate(QQmlContext *context)

このコンポーネントから、指定されたcontext 内にオブジェクトのインスタンスを作成する。作成に失敗した場合はnullptr を返す。

QQmlComponent がインスタンスを作成するときは、3つのステップで行われます：

1. オブジェクト階層が作成され、定数値が割り当てられます。
2. プロパティ・バインディングが初めて評価されます。
3. 該当する場合は、QQmlParserStatus::componentComplete() がオブジェクトに対して呼び出されます。

QQmlComponent::beginCreate()は、QQmlComponent::create()と異なり、ステップ1のみを実行します。ステップ2と3を完了するには、QQmlComponent::completeCreate()を呼び出す必要があります。

このブレークポイントは、インスタンス化されたコンポーネントに情報を伝達するためにアタッチされたプロパティを使用する場合に便利な場合があります。

返されたオブジェクトインスタンスの所有権は、呼び出し元に移ります。

completeCreate() およびQQmlEngine::ObjectOwnershipも参照してください 。

[virtual] void QQmlComponent::completeCreate()

このメソッドは、コンポーネントのインスタンス生成に関する高度な制御を提供する。一般的に、プログラマーはQQmlComponent::create() を使用してコンポーネントを作成する。

この関数は、QQmlComponent::beginCreate() で開始されたコンポーネント作成を完了させるもので、その後に呼び出す必要があります。

beginCreate()も参照 。

[virtual] QObject *QQmlComponent::create(QQmlContext *context = nullptr)

このコンポーネントから、指定されたcontext 内にオブジェクトのインスタンスを作成する。作成に失敗した場合はnullptr を返します。

context がnullptr の場合（デフォルト）、エンジンのroot context にインスタンスを作成します。

返されたオブジェクト・インスタンスの所有権は呼び出し元に移ります。

このコンポーネントから生成されるオブジェクトがビジュアルアイテムの場合、ビジュアルペアレントが必要です。ビジュアルペアレントはQQuickItem::setParentItem() を呼び出すことで設定できます。詳細は Qt Quick の Concepts - Visual Parentを参照してください。

QQmlEngine::ObjectOwnershipも参照してください 。

void QQmlComponent::create(QQmlIncubator &incubator, QQmlContext *context = nullptr, QQmlContext *forContext = nullptr)

提供されたincubator を使用して、このコンポーネントからオブジェクト インスタンスを作成します。context は、オブジェクト インスタンスを作成するコンテキストを指定します。

context がnullptr の場合（デフォルト）、エンジンのroot context にインスタンスが作成されます。

forContext は、このオブジェクト作成が依存するコンテキストを指定します。 が非同期で作成され、 が の場合、このオブジェクトも非同期で作成されます。 が の場合（デフォルト）、この決定には が使用される。forContext QQmlIncubator::IncubationMode QQmlIncubator::AsynchronousIfNested forContext nullptr context

作成されたオブジェクトとその作成ステータスは、incubator 。

QQmlIncubatorも参照のこと 。

QObject *QQmlComponent::createWithInitialProperties(const QVariantMap &initialProperties, QQmlContext *context = nullptr)

指定されたcontext 内に、このコンポーネントのオブジェクト・インスタンスを作成し、その最上位プロパティをinitialProperties で初期化する。

initialProperties のいずれかが設定できない場合、警告が発せられる。未設定の必須プロパティがある場合、オブジェクトの作成は失敗し、nullptr を返します。この場合、isError() はtrue を返します。

QQmlComponent::createも参照 。

QQmlContext *QQmlComponent::creationContext() const

コンポーネントが作成されたQQmlContext を返します。これはQMLから直接作成されたコンポーネントにのみ有効です。

QQmlEngine *QQmlComponent::engine() const

このコンポーネントのQQmlEngine を返します。

QList<QQmlError> QQmlComponent::errors() const

最後のコンパイルまたは作成操作で発生したエラーのリストを返します。isError() が設定されていない場合は、空のリストが返されます。

[since 6.5] bool QQmlComponent::isBound() const

コンポーネントがpragma ComponentBehavior: Bound を指定した QML ファイルで作成された場合は true を返し、そうでない場合は false を返します。

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

bool QQmlComponent::isError() const

status() ==QQmlComponent::Error なら真を返す。

bool QQmlComponent::isLoading() const

status() ==QQmlComponent::Loading なら真を返す。

bool QQmlComponent::isNull() const

status() ==QQmlComponent::Null なら真を返す。

bool QQmlComponent::isReady() const

status() ==QQmlComponent::Ready なら真を返す。

[slot, since 6.5] void QQmlComponent::loadFromModule(QAnyStringView uri, QAnyStringView typeName, QQmlComponent::CompilationMode mode = PreferSynchronous)

typeName のQQmlComponent をモジュールuri にロードする。型がQMLファイルによって実装されている場合、mode 。C++ で実装された型は常に同期的にロードされます。

QQmlEngine engine;
QQmlComponent component(&engine);
component.loadFromModule("QtQuick", "Item");
// once the component is ready
std::unique_ptr<QObject> item(component.create());
Q_ASSERT(item->metaObject() == &QQuickItem::staticMetaObject);

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

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

[slot] void QQmlComponent::loadUrl(const QUrl &url)

提供されたurl からQQmlComponent をロードする。

特に、ローカル・ファイルシステムからファイルをロードする場合は、QUrl::fromLocalFile() を使用すること。

相対パスは、QQmlEngine::baseUrl() に対して解決される。 () は、指定しない限り現在の作業ディレクトリである。

[slot] void QQmlComponent::loadUrl(const QUrl &url, QQmlComponent::CompilationMode mode)

提供されたurl からQQmlComponent をロードする。mode がAsynchronous の場合、コンポーネントは非同期にロードされ、コンパイルされる。

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

相対パスはQQmlEngine::baseUrl() に対して解決される。 () は、指定されない限り、現在の作業ディレクトリである。

[signal] void QQmlComponent::progressChanged(qreal progress)

progress 。0.0（何もロードされていない）から1.0（完了）の間の現在の進捗になります。

[slot] void QQmlComponent::setData(const QByteArray &data, const QUrl &url)

与えられた QMLdata を使うようにQQmlComponent を設定します。url が指定された場合、コンポーネント名を設定し、このコンポーネントによって解決されるアイテムのベースパスを提供するために使用されます。

void QQmlComponent::setInitialProperties(QObject *object, const QVariantMap &properties)

QQmlComponent から作成されたobject のトップレベルproperties を設定する。

このメソッドは、コンポーネント・インスタンス生成の高度な制御を提供する。一般的に、プログラマはQQmlComponent::createWithInitialProperties を使用してコンポーネントからオブジェクト・インスタンスを作成する必要があります。

このメソッドは、beginCreate の後で、completeCreate が呼び出される前に使用します。提供されたプロパティが存在しない場合は、警告が発行されます。

このメソッドでは、ネストされたプロパティの初期値を直接設定することはできません。代わりに、ネストされたプロパティを持つ値型プロパティに初期値を設定するには、その値型を作成し、そのネストされたプロパティを代入してから、構築するオブジェクトの初期プロパティとして値型を渡します。

例えば、fond.boldを設定するには、QFont を作成し、そのウェイトをboldに設定し、フォントを初期プロパティとして渡します。

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

status が新しいステータスとなる。