Value::AttachMovie

Value::AttachMovie
SF_INLINE bool AttachMovie(GFx::Value* pmc, const char* symbolName, const char* instanceName, SInt32 depth = -1, const MemberValueSet* initArgs = NULL);
Description

AttachMovie attaches an instance of a library symbol onto the parent MovieClip. This method behaves the same as the ActionScript 2 MovieClip.attachMovie method.

Parameters
Parameters 
Description 
GFx::Value* pmc 
Pointer to a Value to hold a reference to the newly created MovieClip. 
const char* symbolName 
Name of the library symbol to be attached. 
const char* instanceName 
Name of the symbol instance that is attached. 
SInt32 depth = -1 
The depth of the newly created MovieClip. 
const MemberValueSet* initArgs = NULL 
Initialization Object instance that is copied into the newly created MovieClip. 
Return Value

True if a new symbol instance was attached; false otherwise. The method will also return false if the parent display object does not exist on the stage or it is not a MovieClip.