Correct use of addChild

Question

I'm new to coding and AS3. I was reading about adding things to the stage using AS3 and learned about the addChild method. Reading more I found that there are different ways to use it. I also read that some ways are better than others, and that some ways are not good at all and better avoided.

I don't trust those sources though. As a coding newbie I come asking for help, StackOverflow. I'm about to start an addChild heavy project and I want to start it with the right implementations. I trust you, so let me ask you this: What's the correct use of addChild?

I just want to add things to the stage, but I read that it's not good to add them directly to the stage (without further argument though).

stage.addChild()
this.addChild()
addChild()

Are there other ways? Which one should I use?

Thanks for your time. :)

Answer 1

As the top-level container for all display objects in the display list hierarchy, there is only one Stage no matter how many SWF files are loaded into the runtime. So, generally, objects should not be added to the Stage, directly, at all. The only object the Stage should contain is the root object.

Generally, you should not use: stage.addChild()

Adding a DisplayObject to the display list should be performed within the scope of a DisplayObjectContainer.

Each SWF file has an associated ActionScript class, known as the main class of the SWF file which extends a display object. From this class or any child within the hierarchy you may call addChild().

The following are equal, and would add a child within the scope of the current display object container.

this.addChild()
addChild()

The this keyword explicity defines scope; however, is generally implicit when left off.

While a display object added via addChild() is added to the front (top) of all other children, to add a child to a specific index position, use the addChildAt() method.

References:

• Display Programming
• Basics of display programming
• Adding display objects to the display list