ItemParticle QML Type

パーティクルの描画を行うデリゲートを指定するためのものです。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• delegate : Component
• fade : bool

方法

• void freeze(Item item)
• void give(Item item)
• void take(Item item, bool prioritize)
• void unfreeze(Item item)

詳細説明

物件資料

delegate : Component

各論理パーティクルに対してデリゲートのインスタンスが作成され、そのパーティクルとともに移動します。デリゲートを使用する代わりに、自分で Item インスタンスを作成し、take メソッドを使用してItemParticle に渡して移動させることもできます。

ItemParticle によって作成されたデリゲートインスタンスは、論理パーティクルの有効期限が切れると破棄されます。

fade : bool

true の場合、アイテムの有効期間の開始時と終了時に、自動的にフェードイン・フェードアウトが行われます。false の場合、登場エフェクトは自分で実装する必要があります。

デフォルトは true です。

メソッドのドキュメント

void freeze(Item item)

item が表す論理粒子の時間の流れを一時停止し、その動きを制御できるようにします。

void give(Item item)

ItemParticle に対し、item の制御権をあなたに譲渡するよう指示します。これにより、 による制御は終了し、そのアイテムは論理パーティクルとの関連性を失います。

void take(Item item, bool prioritize)

ItemParticle に対し、item の位置決めを一時的に引き継ぐよう要求します。論理パーティクルが利用可能な場合、その動きに従います。

デフォルトでは、アイテムは論理パーティクルを待機する際にキューに追加されますが、prioritize がtrue である場合、そのアイテムは直ちにキューの先頭に移動します。

ItemParticle は項目の所有権を取得せず、論理パーティクルが期限切れになると制御を解放します。通常、この時点でアイテムをキューに戻したい場合、デリゲート定義内で以下の行を使用することで実現できます：

ItemParticle.onDetached: itemParticleInstance.take(delegateRootItem);

あるいは、デリゲート定義内の以下の行のように、アイテムを削除することもできます：

ItemParticle.onDetached: delegateRootItem.destroy();

void unfreeze(Item item)

item が表す論理粒子の時間の流れを再開し、その粒子が再びパーティクルシステムによって移動できるようになります。