Loader QML Type

このプロパティは、Loader が現在アクティブである場合にtrue になります。このプロパティのデフォルト値はtrue です。

Loader が非アクティブの場合、source またはsourceComponent を変更しても、Loader がアクティブになるまでアイテムはインスタンス化されません。

この値を非アクティブに設定すると、ローダーによってロードされたitem は解放されますが、source やsourceComponent には影響しません。

非アクティブなローダーのstatus は、常にNull である。

source およびsourceComponentも参照のこと 。

このプロパティは、コンポーネントが非同期にインスタンス化されるかどうかを保持します。デフォルトはfalse です。

source プロパティと併用すると、ロードとコンパイルもバックグラウンド・スレッドで実行されます。

非同期にロードすることで、コンポーネントによって宣言されたオブジェクトが複数のフレームにわたって作成され、アニメーションの不具合が発生する可能性が低くなります。非同期にロードする場合、ステータスはLoader.Loadingに変わります。コンポーネント全体が作成されると、item 、ステータスがLoader.Readyに変わります。

非同期ロードの進行中にこのプロパティの値をfalse に変更すると、直ちに同期的に完了します。これにより、非同期ロードを開始し、非同期ロードが完了する前にローダーのコンテンツにアクセスする必要がある場合に、強制的に完了させることができます。

アイテムが徐々にロードされるのを見ないようにするには、visible を適切に設定します。

Loader {
    source: "mycomponent.qml"
    asynchronous: true
    visible: status == Loader.Ready
}

このプロパティは、オブジェクトのインスタンス生成にのみ影響することに注意してください。

このプロパティは、現在ロードされているトップレベルのオブジェクトを保持します。

QtQuick 2.0 以降、Loader は任意のオブジェクト・タイプをロードできます。

このプロパティは、ネットワークからのQMLデータのロードの進捗状況を0.0（何もロードされていない）から1.0（完了）まで保持します。ほとんどのQMLファイルは非常に小さいので、この値は0から1へと急速に変化します。

statusも参照してください 。

このプロパティは、インスタンス化するQMLコンポーネントのURLを保持します。

QtQuick 2.0 以降、Loader はどのようなタイプのオブジェクトでもロードすることができます。

現在ロードされているオブジェクトをアンロードするには、このプロパティに空文字列を 設定するか、sourceComponent にundefined を設定します。source に新しい URL を設定すると、前の URL で作成されたアイテムもアンロードされます。

sourceComponent 、status 、progressも参照してください 。

このプロパティは、インスタンス化するComponent を保持します。

Item {
    Component {
        id: redSquare
        Rectangle { color: "red"; width: 10; height: 10 }
    }

    Loader { sourceComponent: redSquare }
    Loader { sourceComponent: redSquare; x: 10 }
}

現在ロードされているオブジェクトをアンロードするには、このプロパティをundefined に設定します。

QtQuick 2.0 以降、Loader はあらゆるタイプのオブジェクトをロードできます。

source およびprogressも参照して ください。

このプロパティは、QML のロード状態を保持します。次のいずれかになります：

• Loader.Null - ローダーが非アクティブ、またはQMLソースが設定されていない。
• Loader.Ready - QMLソースがロードされました。
• Loader.Loading - QMLソースが現在ロードされています。
• Loader.Error - QML ソースの読み込み中にエラーが発生しました。

このステータスを使用して、最新情報を提供したり、何らかの方法でステータスの変化に対応したりします。例えば、以下のようなことが可能です：

• 状態変更をトリガーする：

  State { name: 'loaded'; when: loader.status == Loader.Ready }

• onStatusChanged シグナルハンドラを実装する：

  Loader {
      id: loader
      onStatusChanged: if (loader.status == Loader.Ready) console.log('Loaded')
  }

• ステータス値にバインドする：

  Text { text: loader.status == Loader.Ready ? 'Loaded' : 'Not loaded' }

ソースがローカル・ファイルの場合、ステータスは最初はReady（またはError）であることに注意。この場合、onStatusChanged シグナルは発生しませんが、onLoaded シグナルは起動されます。

progressも参照してください 。

このシグナルは、status がLoader.Ready になったとき、または初期ロードに成功したときに発せられる。

与えられたproperties を持つ、与えられたsource コンポーネントのオブジェクトインスタンスを作成します。properties 引数は省略可能です。このインスタンスは、ロードとインスタンス化が完了すると、item プロパティからアクセスできるようになります。

この関数が呼ばれた時点でactive プロパティがfalse の場合、与えられたsource コンポーネントはロードされませんが、source と初期properties はキャッシュされます。ローダーがactive になると、source コンポーネントのインスタンスが、初期properties が設定された状態で作成される。

この方法でコンポーネントのインスタンスの初期プロパティ値を設定しても、関連するBehaviorはトリガされません。

この関数を呼び出した後、ローダーactive を設定する前にsource またはsourceComponent を変更すると、キャッシュされたproperties はクリアされることに注意。

例

// ExampleComponent.qml
import QtQuick 2.0
Rectangle {
    id: rect
    color: "red"
    width: 10
    height: 10

    Behavior on color {
        NumberAnimation {
            target: rect
            property: "width"
            to: (rect.width + 20)
            duration: 0
        }
    }
}

// example.qml
import QtQuick 2.0
Item {
    Loader {
        id: squareLoader
        onLoaded: console.log(squareLoader.item.width);
        // prints [10], not [30]
    }

    Component.onCompleted: {
        squareLoader.setSource("ExampleComponent.qml",
                             { "color": "blue" });
        // will trigger the onLoaded code when complete.
    }
}

source およびactiveも参照のこと 。