Component QML Type

0.0（何もロードされていない）から 1.0（完了）までの、コンポーネントのロードの進捗状況。

このプロパティは、コンポーネントのロード状態を保持する。状態は以下のいずれかになります：

コンポーネントの URL。これは、コンポーネントを構築するために使用されたURLです。

オブジェクトがインスタンス化された後に発行されます。このシグナルは、QMLの完全な環境が構築された後、起動時にスクリプトコードを実行するために使用することができます。

onCompleted シグナルハンドラはどのオブジェクトでも宣言できます。ハンドラの実行順序は不定です。

Rectangle {
    Component.onCompleted: console.log("Completed Running!")
    Rectangle {
        Component.onCompleted: console.log("Nested Completed Running!")
    }
}

オブジェクトが破壊を開始するときに発行されます。これは、completed() シグナルに応答して行われた作業や、アプリケーション内の他の命令的なコードを元に戻すために使用できます。

onDestruction シグナル・ハンドラは、どのオブジェクトでも宣言できます。ハンドラの実行順序は不定です。

Rectangle {
    Component.onDestruction: console.log("Destruction Beginning!")
    Rectangle {
        Component.onDestruction: console.log("Nested Destruction Beginning!")
    }
}

も参照してください。 Qt Qml.

与えられたparent とproperties を持つこのコンポーネントのオブジェクトインスタンスを作成し、返します。properties 引数は省略可能です。オブジェクトの作成に失敗した場合は null を返します。

オブジェクトは、コンポーネントが作成されたコンテキストと同じコンテキストで作成されます。QMLで作成されていないコンポーネントに対してこの関数を呼び出すと、常にNULLが返されます。

親を設定せずにオブジェクトを作成したい場合は、parent の値にnull を指定してください。返されたオブジェクトを表示する場合は、有効なparent の値を指定するか、返されたオブジェクトのparent プロパティを設定する必要があります。

createObject()にparent を指定しない場合、ガベージ・コレクタによって破棄されないように、返されるオブジェクトへの参照を保持しなければならない。Itemの親を設定してもオブジェクトの所有権は変更されないので、これはItem::parent が後で設定されるかどうかに関係なく当てはまります。グラフィカルな親だけが変更されます。

QtQuick 1.1 の時点で、このメソッドは、作成されるオブジェクトの初期プロパティ値のマップを指定するオプションの引数properties を受け入れます。これらの値は、オブジェクトの作成が確定する前に適用されます。これは、オブジェクト生成後にプロパティ値を設定するよりも効率的で、特に大きなプロパティ値のセットが定義されている場合、オブジェクトが生成される前にプロパティバインディングを設定することもできます（Qt.binding を使用）。

properties 引数は、プロパティ値項目のマップとして指定されます。例えば、以下のコードでは、x とy の初期値がそれぞれ 100 と 100 のオブジェクトが作成されます：

const component = Qt.createComponent("Button.qml");
if (component.status === Component.Ready) {
    component.createObject(parent, { x: 100, y: 100 });
}

動的に生成されたインスタンスはdestroy() メソッドで削除することができます。詳しくは「JavaScriptによる動的なQMLオブジェクトの生成」を参照してください。

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

エラーの内容を人間が読める形で返します。

文字列には各エラーのファイル名、場所、説明が含まれます。複数のエラーが存在する場合は、改行文字で区切られます。

エラーがない場合は、空の文字列が返されます。

このコンポーネントのインスタンスのインキュベータを作成します。インキュベータを使用すると、新しいコンポーネントインスタンスを非同期にインスタンス化でき、UIがフリーズすることもありません。

parent 引数は、作成されるインスタンスが持つ親を指定します。このパラメータを省略するかNULLを渡すと、親を持たないオブジェクトが作成されます。この場合、ガベージコレクタによって破棄されないように、作成されたオブジェクトへの参照を保持する必要があります。

properties 引数は、作成されたオブジェクトの構築時に設定されるプロパティ値項目のマップとして指定します。mode には Qt.Synchronous または Qt.Asynchronous を指定し、インスタンスが同期的に作成されるか、非同期的に作成されるかを制御します。デフォルトは非同期です。状況によっては、Qt.Synchronousが指定されていても、インキュベーターはオブジェクトを非同期で作成することがあります。これは、incubateObject() を呼び出しているコンポーネント自身が非同期で生成されている場合に起こります。

3つの引数はすべてオプションです。

成功した場合、このメソッドはインキュベータを返します。インキュベーターには以下のプロパティがあります：

• status - インキュベータのステータス。有効な値は、Component.Ready、Component.Loading、および Component.Errorです。
• object - 作成されたオブジェクトのインスタンス。インキュベーターがReadyステータスになったときのみ使用可能です。
• onStatusChanged - ステータスが変更されたときに呼び出されるコールバック関数を指定します。ステータスはコールバックのパラメータとして渡されます。
• forceCompletion() - 同期的にインキュベーションを完了するために呼び出します。

次の例は、インキュベータの使用方法を示しています：

const component = Qt.createComponent("Button.qml");

const incubator = component.incubateObject(parent, { x: 10, y: 10 });
if (incubator.status !== Component.Ready) {
    incubator.onStatusChanged = function(status) {
        if (status === Component.Ready) {
            print("Object", incubator.object, "is now ready!");
        }
    };
} else {
    print("Object", incubator.object, "is ready immediately!");
}

動的に生成されたインスタンスはdestroy() メソッドで削除することができます。詳しくはDynamic QML Object Creation from JavaScriptを参照してください。

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