親子関係機能

概要

親子関係機能とは、オブジェクトに親子関係を設定することで、親のオブジェクトのパラメータの値を子のオブジェクトに受け継がせる機能です。たとえば、あるオブジェクトの周りをぐるぐる回るオブジェクトなどはこの機能を使うと手軽に実現できます。親子関係は2Dオブジェクト(Object2Dの派生クラス)に対して設定できます。

使い方

Object2D.AddChildメソッドを呼び出すことでオブジェクトを子オブジェクトとして親オブジェクトに追加できます。引数に渡すための列挙体がいくつか定義されていて、以下のように使います。

// ChildManagementMode, ChildTransformingModeは列挙体
// parentを親オブジェクト、childを子オブジェクトとして親子関係を設定する。変形情報のみを同期する。
parent.AddChild(child, ChildManagementMode.Nothing, ChildTransformingMode.All);

DrawnObject2D.AddDrawnChildメソッドを呼び出すことで、通常の親子関係で同期できる項目に加えて色と描画優先度も同期することができます。以下のように使います。

// ChildDrawingModeは列挙体
// 変形情報と色を同期する。
parent.AddDrawnChild(child,
    ChildManagementMode.Nothing,
    ChildTransformingMode.All,
    ChildDrawingMode.Color);

ChildManagementModeとChildDrawingMode型の引数にはOR演算子でつなげて複数の項目を指定できます。

// レイヤーへの登録状況、更新するかどうかのフラグ、色、描画優先度を同期する。
parent.AddChild(child,
    ChildManagementMode.RegistrationToLayer | ChildManagementMode.IsUpdated,
    ChildTransformingMode.Nothing,
    ChildDrawingMode.Color | ChildDrawingMode.DrawingPriority);

注意点

他のオブジェクトの子オブジェクトとして登録したオブジェクトも、基本的には改めてレイヤーのAddObjectでレイヤーに登録しなければ描画されません。レイヤーへの登録状況を親オブジェクトと同期するには、後述するChildManagementModeを適切に設定してください。

同期できるものと同期方法

以下のパラメータを同期することができます。

オブジェクト管理系(ChildManagementMode)

変形系(ChildTransformingMode)

描画系(ChildDrawingMode)

これらのパラメータはDrawnObject2Dの派生クラスでのみ同期することができます。

親子関係関連のオブジェクトのプロパティ

Object2Dクラスには以下のプロパティが用意されており、親子関係に関する情報にアクセスできます。