NodeInstantiator QML Type

ノードを動的に作成します。詳細...

• 継承されたメンバを含む全メンバのリスト

プロパティ

• active : bool
• asynchronous : bool
• count : int
• delegate : QtQml::Component
• model : variant
• object : QtQml::QtObject

信号

• objectAdded(int index, QtObject object)
• objectRemoved(int index, QtObject object)

方法

• object objectAt(int index)

詳細説明

NodeInstantiator を使用して、ノードの動的な作成を制御したり、テンプレートから複数のオブジェクトを動的に作成したりすることができます。

NodeInstantiator 要素は、作成したオブジェクトを管理します。NodeInstantiator 要素は、それが作成するオブジェクトを管理します。これらのオブジェクトは、Instantiator の親となり、NodeInstantiator のプロパティが変更された場合は、NodeInstantiator によって削除することもできます。また、NodeInstantiator のプロパティが変更されない限り、NodeInstantiator はノードを再作成しません。

プロパティのドキュメント

active : bool

active がtrue で、デリゲート・コンポーネントの準備ができているとき、インスタン ティエーターはモデルに従ってオブジェクトを作成する。active がfalse の場合、オブジェクトは作成されず、以前に作成されたオブジェクトは破棄されます。

デフォルトはtrue です。

asynchronous : bool

asynchronousがtrueの場合、インスタンティエイターはオブジェクトを非同期に作成しようとします。つまり、activeがtrueに設定されていても、オブジェクトはすぐに利用できない可能性があります。

objectAdded シグナルを使用して、アイテムが作成されたことに応答することができます。

デフォルトはfalse です。

count : int [read-only]

Instantiator が現在管理しているオブジェクトの数。

delegate : QtQml::Component [default]

すべてのオブジェクトの生成に使用されるコンポーネント。

デリゲートのインスタンス内部では、indexという追加の変数が利用できることに注意してください。この変数は、インスタンシエータ内部のインスタンスのインデックスを指し、インスタンシエータのitemAtメソッドを通してオブジェクトを取得するために使用することができます。

このプロパティが変更されると、古いデリゲートを使用していたインスタンスはすべて破棄され、新しいデリゲートを使用して新しいインスタンスが作成されます。

model : variant

このプロパティには、サポートされているデータモデルのいずれかを設定することができる：

• リピータによって作成されるデリゲートの数を示す数値。
• モデル (例えば、ListModel アイテムまたはQAbstractItemModel サブクラス)
• 文字列リスト
• オブジェクト・リスト

モデルのタイプは、delegate に公開されるプロパティに影響します。

デフォルト値は 1 で、1 つのデリゲート・インスタンスが作成されます。

データモデル」も参照してください 。

object : QtQml::QtObject [read-only]

これは、最初に作成されたオブジェクトへの参照であり、オブジェクトが1つしか作成されていない場合の便宜を図ったものである。

シグナル・ドキュメント

objectAdded(int index, QtObject object)

このシグナルは、ノードがNodeInstantiator に追加されたときに発行される。index パラメータは、ノードが与えられたインデックスを保持し、object パラメータは、追加されたNode を保持する。

対応するハンドラはonNodeAdded 。

objectRemoved(int index, QtObject object)

このシグナルは、オブジェクトがInstantiatorから削除されたときに発行される。index パラメーターはオブジェクトが与えられていたインデックスを保持し、object パラメーターは削除されたQtObject を保持します。

object への参照を保持しないでください。 がこのインスタンティエイターによって作成された場合、このシグナルが処理された直後に削除されるからです。

対応するハンドラはonObjectRemoved です。

メソッドのドキュメント

object objectAt(int index)

与えられたindex を持つオブジェクトへの参照を返す。