NodeInstantiator QML Type

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

Import Statement: import Qt3D.Core 2.8
Status: Deprecated

プロパティ

シグナル

メソッド

詳細説明

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 [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

注: 対応するハンドラはonObjectAdded である。


objectRemoved(int index, QtObject object)

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

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

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

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


メソッド・ドキュメント

QtQml::QtObject objectAt(int index)

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


©2024 The Qt Company Ltd. 本書に含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。