SIObject.Parent

説明

オブジェクトの親(SIObject から派生するオブジェクト)を、次のように戻します。

シーン ルートの Parent プロパティを呼び出す場合は(Model)、Parent プロパティ自身を戻します。

その他の X3DObject の Parent プロパティを呼び出す場合は、その X3DObject の親が戻されます。

Property の Parent プロパティを呼び出す場合は、そのプロパティを所有する X3DObject が戻されます。

Parameter の Parent プロパティを呼び出す場合は、そのパラメータが直接含まれる ProjectItem が戻されます。ProjectItem.Parameters コレクションには子オブジェクト内のパラメータが含まれていることがよくあります。たとえば、X3DObject には、実際に Kinematics やその他のネストされているプロパティからきたパラメータが含まれていることがあります。このため、Parent プロパティはパラメータがどこから来たものかを判断する上で、非常に役立ちます。この概念は、以下の例に表されています。

ジオメトリコンポーネント(PointGeometry、または Segment)の Parent プロパティを呼び出す場合は、親 Facet が戻されます。

SubComponent の Parent プロパティを呼び出した場合は、親ジオメトリが戻されます。これは、SubComponent オブジェクトにはジオメトリコンポーネントへの参照が含まれているためです(サブコンポーネントの親である実際の X3DObject を取得するには、SubComponent.Parent3DObject を使用します)。

Primitive 上の Parent プロパティを呼び出す場合は、親 Cluster が戻されます。

Operator 上の Parent プロパティを呼び出す場合は、オペレータの最初の OutputPort のターゲットが戻されます。

モデルの下のActionSourceの Parent プロパティを呼び出すと、Modelが戻されます。SimulationEnvironment キャッシュ上の Parent プロパティを呼び出すと、SimulationEnvironment が戻されます。この変更は v5.0 によるものです。以前のリリースでは、Mixer オブジェクトが戻されていました。

- 親を持たない Application オブジェクト(オブジェクトなど)の Parent プロパティを呼び出すと、オブジェクトが親として戻されます。

Command のような単純なオブジェクトは、親として XSIApplication を戻します。

ヒント:共用されているMaterialのように、オブジェクトの中には実際に複数の親を持つものもあります。そして中には、同じオブジェクトがシーンエキスプローラ内やグラフ内の複数の場所に現れるという場合もあります。このような場合は、ProjectItem.Owners プロパティを使用してすべての「親」にアクセスできます。

注:現在、SIObject のすべてのネストされた子を見つけるための、同様なプロパティは存在しません。代わりに、これらの子は、タイプ(X3DObject.ChildrenProjectItem.ParametersParticleCloudPrimitive.ParticlesX3DObject.Primitives など)に応じてさまざまなコレクションで使用できます。EnumElements コマンドは、タイプに関らず、すべての子を見つける方法の 1 つです。

C#構文

// get accessor

Object rtn = SIObject.Parent;

1. VBScript の例

'

'	This example displays the name of the object's parent

'

set oObj = ActiveProject.ActiveScene.Root.AddGeometry("Sphere", "NurbsSurface")

Application.LogMessage oObj.Parent.Name

2. VBScript の例

set oObject = ActiveSceneroot.AddGeometry("Cube","MeshSurface","MyCube")

set oCluster = oObject.ActivePrimitive.Geometry.AddCluster(siVertexCluster,"MyCluster",Array(3,4,5))

set oSubComponent = oCluster.CreateSubComponent

set oClusterGeometry = oSubComponent.Parent

set oObjectGeometry = oObject.Parent

Application.LogMessage "The parent of " & oSubComponent & " is " & oClusterGeometry

Application.LogMessage "The parent of the " & oObject & " is " & oObjectGeometry

' OUTPUT OF ABOVE SCRIPT IS:

'INFO : "The parent of MyCube.pnt[3-5] is polymsh"

'INFO : "The parent of the MyCube is Scene_Root"

3. Python の例

#

#	This Python example demonstrates how the Parent property can 

#	be used to travel from a child SIObject to its parent

#

# Expected results: each line in the scripted history should print "True"

# Prepare a simple scene and collect some object model

# references to objects inside it

Application.NewScene( "", 0 )

oSceneRoot = Application.ActiveSceneRoot

oNull = oSceneRoot.AddNull()

oNullLocalKine = oNull.Kinematics.Local

oNestedCone = oNull.AddGeometry( "Cone","MeshSurface","NestedCone")

oNestedConeGeom = oNestedCone.ActivePrimitive2.Geometry

# Parent of Scene Root is itself

Application.LogMessage( oSceneRoot.Parent.IsEqualTo( oSceneRoot ) ) 

# Parent of Null is the Scene Root

Application.LogMessage( oNull.Parent.IsEqualTo( oSceneRoot ) )

# Parent of nested cone is the Null

Application.LogMessage( oNestedCone.Parent.IsEqualTo( oNull ) )

# Parent of a property is the direct owner

Application.LogMessage( oNull.Kinematics.Parent.IsEqualTo( oNull ) )

# Parent of a parameter

Application.LogMessage( oNullLocalKine.Parameters("posx").Parent.FullName 

						== oNullLocalKine.FullName )

# This same parameter also appears directly under the Null,

# but the Parent property tells the truth about where it comes from

Application.LogMessage( oNull.Parameters("posx").Parent.FullName 

						== oNullLocalKine.FullName )

# Use Parent to travel all the way from a Point to its X3DObject

Application.LogMessage( oNestedConeGeom.Points(0).Parent.Parent.Parent.IsEqualTo( oNestedCone ) )

# Command object just returns the XSIApplication as its parent

Application.LogMessage( Application.Commands(0).Parent.IsEqualTo( Application ) )

関連項目

SubComponent.Parent3DObject EnumElements ProjectItem.Owners X3DObject.Children