The three virtues of a programmer: Laziness, Impatience, and Hubris. – Larry Wall

View source

From Unreal Wiki, The Unreal Engine Documentation Site

You do not have permission to do that, for the following reason:

The action you have requested is limited to users in the group user.

You can view and copy the source of this page:

The term '''subobject''' refers to a special kind of object and its textual definition in a [[defaultproperties]] block of a class in. Depending on the context, a subobject can either be a template or an actual object. In [[Unreal Engine 3]] they are generally templates (actually [[archetypes]]), while in [[Unreal Engine 2]] subobjects are generally actual objects unless their class is declared with the [[Class#Modifiers|class modifier]] "instanced", which applies to all [[UE2:GUI (UT2004)|GUI]] subclasses in [[UT2003]] and [[UT2004]]. There is no support for subobjects in [[Unreal Engine 1]].

Subobjects that are only templates are "instanced" (i.e. created) when an object of the class containing the subobject definition is created. Generally, the property '''Outer''' of an instanced subobject points to the containing object, while the '''Outer''' property of "actual object" subobjects points to the class defining the subobject. An example for the latter case is the UT200x class [[UE2:Shark (UT2004)|xEffects.Shark]], which creates a [[UE2:FinalBlend (UT2004)|FinalBlend]] as a subobject and uses it as Skin.

==Syntax==
To define a subobject, add the following to the defaultproperties block of your class:
 '''Begin Object Name='''''objectname'' '''Class='''''classname''
    ''subobject properties''
 '''End Object'''
For the subobject properties the same syntax and rules apply as for the defaultproperties block itself.

The Class=&hellip; part is optional in [[Unreal Engine 3]]. Omitting it means that you want to duplicate a subobject with the same name defined in a parent class.

==Subobjects in exported source code==
It is generally a good idea to be suspicious of any [[defaultproperties]] section in a [[UC file]] created by exporting scripts from a compiled package. This goes especially for subobjects!

Subobject definitions may not get exported at all in early [[Unreal Engine 2]] implementations. In newer versions subobjects will only be exported if they are either assigned to at least one property declared with the [[Variables#Modifiers|modifier]] '''export''' or if a property they are assigned to is of a type that is declared as '''instanced'''. For example a tooltip object assigned to the [[UE2:GUIComponent properties (UT2004)#ToolTip|GUIComponent.ToolTip]] property would get exported because the property's type is [[UE2:GUIToolTip (UT2004)|GUIToolTip]], a subclass of [[UE2:GUI (UT2004)|GUI]], which is declared with the '''instanced''' class modifier. Any karma parameter subobject assigned to the [[UE2:Actor properties (UT2004)#KParams|Actor.KParams]] property would be exported because that property is declared with the '''export''' variable modifier.

Subobjects in [[Unreal Engine 3]] are only exported if the subobject's class is a subclass of [[UE3:Component (UT3)|Component]]. A prominent example of this behavior is the [[UE3:UIObject (UT3)|UIObject]] class. Its subobject WidgetInitializedEvent is not exported because it's a [[UE3:UIEvent_Initialized (UT3)|UIEvent_Initialized]], which is not a Component subclass, while its other subobject [[UE3:UIObject (UT3)#WidgetEventComponent|WidgetEventComponent]] (class [[UE3:UIComp_Event (UT3)|UIComp_Event]]) is exported.<br/>
'''Note:''' [[UT3]] adds illegal syntax elements to exported subobjects. Your subobject definition should not have an ObjName=&hellip; or Archetype=&hellip; clause in its Begin Object line and neither should it define values for the Name or ObjectArchetype properties in the subobject body.

As you can see, it's always a good idea to have a look at the original (downloaded, not exported) sources if you want to find out about subobject usage.

{{navbox unrealscript}}

Templates used on this page:

Return to Subobjects.

Retrieved from "http://wiki.beyondunreal.com/Subobjects"

View source

From Unreal Wiki, The Unreal Engine Documentation Site

Views

Personal tools

Navigation

Search

Toolbox