Packagegraphics.display
Classpublic class DisplayObjectContainers
InheritanceDisplayObjectContainers Inheritance Object

The DisplayObjectContainer tool class.



Public Methods
 MethodDefined By
  
clear(container:DisplayObjectContainer):void
[static] Removes all childs in the specified container.
DisplayObjectContainers
  
move(child:DisplayObject, container:DisplayObjectContainer, index:int = -1):Boolean
[static] Moves a specified child object in the specified container at the specified z-depth value.
DisplayObjectContainers
  
swapChildren(child1:DisplayObject, child2:DisplayObject):Boolean
[static] Swaps the z-order and the container of the two specified childs objects.
DisplayObjectContainers
Method Detail
clear()method
public static function clear(container:DisplayObjectContainer):void

Removes all childs in the specified container.

Example :

         import graphics.display.DisplayObjectContainers ;
         
         var display1:Sprite = new Sprite() ;
         var display2:Sprite = new Sprite() ;
         
         var container:Sprite   = new Sprite() ;
         
         container.addChild( display1 );
         container.addChild( display2 );
         
         trace( container.numChildren ) ;
         
         DisplayObjectContainers.clear( container ) ;
         
         trace( container.numChildren ) ;
         

Parameters

container:DisplayObjectContainer

move()method 
public static function move(child:DisplayObject, container:DisplayObjectContainer, index:int = -1):Boolean

Moves a specified child object in the specified container at the specified z-depth value.

Example :

         import graphics.display.DisplayObjectContainers ;
         
         var display1:Sprite = new Sprite() ;
         display1.graphics.beginFill( 0xF55B1B , 1 ) ;
         display1.graphics.drawCircle(0, 0, 30 ) ;
         
         var display2:Sprite = new Sprite() ;
         display2.graphics.beginFill( 0x3D6AD3 , 1 ) ;
         display2.graphics.drawRect(0, 0, 60, 60) ;
         
         var container1:Sprite   = new Sprite() ;
         container1.mouseEnabled = false ;
         container1.x            = 100 ;
         container1.y            = 150 ;
         
         var container2:Sprite   = new Sprite() ;
         container2.mouseEnabled = false ;
         container2.x            = 200 ;
         container2.y            = 150 ;
         
         addChild( container1 );
         addChild( container2 );
         
         container1.addChild( display1 ) ;
         container2.addChild( display2 ) ;
         
         var down:Function = function( e:MouseEvent ):void
         {
             DisplayObjectContainers.move( display1, container2 , 0 ) ;
         }
         
         stage.addEventListener( MouseEvent.MOUSE_DOWN , down ) ;
         

Parameters

child:DisplayObject
 
container:DisplayObjectContainer
 
index:int (default = -1)

Returns
Boolean
swapChildren()method 
public static function swapChildren(child1:DisplayObject, child2:DisplayObject):Boolean

Swaps the z-order and the container of the two specified childs objects.

Example :

         import graphics.display.DisplayObjectContainers ;
         
         var display1:Sprite = new Sprite() ;
         display1.graphics.beginFill( 0xF55B1B , 1 ) ;
         display1.graphics.drawCircle(30, 30, 30 ) ;
         
         var display2:Sprite = new Sprite() ;
         display2.graphics.beginFill( 0x3D6AD3 , 1 ) ;
         display2.graphics.drawRect(0, 0, 60, 60) ;
         
         var container1:Sprite   = new Sprite() ;
         container1.mouseEnabled = false ;
         container1.x            = 20 ;
         container1.y            = 20 ;
         
         var container2:Sprite   = new Sprite() ;
         container2.mouseEnabled = false ;
         container2.x            = 150 ;
         container2.y            = 20 ;
         
         addChild( container1 );
         addChild( container2 );
         
         container1.addChild( display1 ) ;
         container2.addChild( display2 ) ;
         
         var click:Function = function( e:MouseEvent ):void
         {
             DisplayObjectContainers.swapChildren( display1, display2 ) ;
         }
         
         stage.addEventListener( MouseEvent.CLICK , click ) ;
         

Parameters

child1:DisplayObject
 
child2:DisplayObject

Returns
Boolean — true if the two DisplayObject objects are swapped.