NodeInstantiator QML Type
ノードを動的に作成します。詳細...
Import Statement: | import Qt3D.Core 2.8 |
Status: | Deprecated |
プロパティ
- active : bool
- asynchronous : bool
- count : int
- delegate : QtQml::Component
- model : variant
- object : QtQml::QtObject
信号
- objectAdded(int index, QtObject object)
- objectRemoved(int index, QtObject object)
方法
- QtQml::QtObject objectAt(int index)
詳細説明
NodeInstantiator を使用して、ノードの動的な作成を制御したり、テンプレートから複数のオブジェクトを動的に作成したりすることができます。
NodeInstantiator 要素は、作成したオブジェクトを管理します。NodeInstantiator 要素は、それが作成するオブジェクトを管理します。これらのオブジェクトは、Instantiator の親となり、NodeInstantiator のプロパティが変更された場合は、NodeInstantiator によって削除することもできます。また、NodeInstantiator のプロパティが変更されない限り、NodeInstantiator はノードを再作成しません。
プロパティの記述
active : bool |
active がtrue
で、デリゲート・コンポーネントの準備ができている場合、インスタン ティエーターはモデルに従ってオブジェクトを生成します。active がfalse
の場合、オブジェクトは作成されず、以前に作成されたオブジェクトは破棄されます。
デフォルトはtrue
です。
asynchronous : bool |
asynchronousがtrueの場合、Instantiatorはオブジェクトを非同期に作成しようとします。つまり、activeがtrueに設定されていても、オブジェクトがすぐに利用できるとは限りません。
objectAdded シグナルを使用して、アイテムの作成に応答することができます。
デフォルトはfalse
です。
count : int |
Instantiator が現在管理しているオブジェクトの数。
delegate : QtQml::Component |
すべてのオブジェクトの作成に使用されるコンポーネント。
デリゲートのインスタンス内部では、indexという追加の変数が利用できることに注意してください。この変数は、インスタンシエーター内部のインスタンスのインデックスを指し、インスタンシエーターのitemAtメソッドを通してオブジェクトを取得するために使用することができます。
このプロパティが変更されると、古いデリゲートを使用していたインスタンスはすべて破棄され、新しいデリゲートを使用して新しいインスタンスが作成されます。
model : variant |
このプロパティは、サポートされているデータモデルのいずれかに設定できます:
- リピータが作成するデリゲートの数を示す数値。
- モデル(例えば、ListModel 項目やQAbstractItemModel サブクラス)。
- 文字列リスト
- オブジェクト・リスト
モデルのタイプは、delegate に公開されるプロパティに影響します。
デフォルト値は 1 で、1 つのデリゲート・インスタンスが作成されます。
データ・モデル」も参照してください 。
object : QtQml::QtObject |
これは、最初に作成されたオブジェクトへの参照で、オブジェクトが1つしか作成されなかった場合の便宜を図ったものです。
シグナル・ドキュメント
このシグナルは、NodeInstantiator にノードが追加されたときに発行されます。index パラメータはノードに与えられたインデックスを保持し、object パラメータは追加されたNode を保持します。
対応するハンドラはonNodeAdded
。
注: 対応するハンドラはonObjectAdded
である。
このシグナルは、オブジェクトがインスタンシエータから削除されたときに発行される。index パラメーターはオブジェクトが与えられていたインデックスを保持し、object パラメーターは削除されたQtObject を保持します。
object への参照を保持しないでください。 がこのインスタンティエイターによって作成された場合、このシグナルが処理された直後に削除されるからです。
対応するハンドラはonObjectRemoved
です。
注: 対応するハンドラはonObjectRemoved
です。
メソッド・ドキュメント
QtQml::QtObject objectAt(int index) |
与えられたindex を持つオブジェクトへの参照を返します。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.