<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>DisplayObjectContainer - Pixi.JS</title> <link rel="stylesheet" href="http://yui.yahooapis.com/3.8.0/build/cssgrids/cssgrids-min.css"> <link rel="stylesheet" href="../assets/vendor/prettify/prettify-min.css"> <link rel="stylesheet" href="../assets/css/main.css" id="site_styles"> <link rel="shortcut icon" type="image/png" href="../assets/favicon.png"> <script src="http://yui.yahooapis.com/combo?3.8.0/build/yui/yui-min.js"></script> </head> <body class="yui3-skin-sam"> <div id="doc"> <div id="hd" class="yui3-g header"> <div class="yui3-u-3-4"> <h1><img src="http://www.goodboydigital.com/pixijs/logo_small.png" title="Pixi.JS"></h1> </div> <div class="yui3-u-1-4 version"> <em>API Docs for: 1.0.0</em> </div> </div> <div id="bd" class="yui3-g"> <div class="yui3-u-1-4"> <div id="docs-sidebar" class="sidebar apidocs"> <div id="api-list"> <h2 class="off-left">APIs</h2> <div id="api-tabview" class="tabview"> <ul class="tabs"> <li><a href="#api-classes">Classes</a></li> <li><a href="#api-modules">Modules</a></li> </ul> <div id="api-tabview-filter"> <input type="search" id="api-filter" placeholder="Type to filter APIs"> </div> <div id="api-tabview-panel"> <ul id="api-classes" class="apis classes"> <li><a href="../classes/AssetLoader.html">AssetLoader</a></li> <li><a href="../classes/BaseTexture.html">BaseTexture</a></li> <li><a href="../classes/CanvasRenderer.html">CanvasRenderer</a></li> <li><a href="../classes/DisplayObject.html">DisplayObject</a></li> <li><a href="../classes/DisplayObjectContainer.html">DisplayObjectContainer</a></li> <li><a href="../classes/InteractionData.html">InteractionData</a></li> <li><a href="../classes/InteractionManager.html">InteractionManager</a></li> <li><a href="../classes/MovieClip.html">MovieClip</a></li> <li><a href="../classes/Point.html">Point</a></li> <li><a href="../classes/Rectangle.html">Rectangle</a></li> <li><a href="../classes/Sprite.html">Sprite</a></li> <li><a href="../classes/SpriteSheetLoader.html">SpriteSheetLoader</a></li> <li><a href="../classes/Stage.html">Stage</a></li> <li><a href="../classes/Texture.html">Texture</a></li> <li><a href="../classes/TilingSprite.html">TilingSprite</a></li> <li><a href="../classes/WebGLBatch.html">WebGLBatch</a></li> <li><a href="../classes/WebGLRenderer.html">WebGLRenderer</a></li> </ul> <ul id="api-modules" class="apis modules"> <li><a href="../modules/PIXI.html">PIXI</a></li> </ul> </div> </div> </div> </div> </div> <div class="yui3-u-3-4"> <div id="api-options"> Show: <label for="api-show-inherited"> <input type="checkbox" id="api-show-inherited" checked> Inherited </label> <label for="api-show-protected"> <input type="checkbox" id="api-show-protected"> Protected </label> <label for="api-show-private"> <input type="checkbox" id="api-show-private"> Private </label> <label for="api-show-deprecated"> <input type="checkbox" id="api-show-deprecated"> Deprecated </label> </div> <div class="apidocs"> <div id="docs-main"> <div class="content"> <h1>DisplayObjectContainer Class</h1> <div class="box meta"> <div class="extends"> Extends <a href="../classes/DisplayObject.html" class="crosslink">DisplayObject</a> </div> <div class="foundat"> Defined in: <a href="../files/src_pixi_DisplayObjectContainer.js.html#l6"><code>src/pixi/DisplayObjectContainer.js:6</code></a> </div> Module: <a href="../modules/PIXI.html">PIXI</a> </div> <div class="box intro"> <p>A DisplayObjectContainer represents a collection of display objects. It is the base class of all display objects that act as a container for other objects.</p> </div> <div class="constructor"> <h2>Constructor</h2> <div id="method_DisplayObjectContainer" class="method item"> <h3 class="name"><code>DisplayObjectContainer</code></h3> <span class="paren">()</span> <div class="meta"> <p> Defined in <a href="../files/src_pixi_DisplayObjectContainer.js.html#l6"><code>src/pixi/DisplayObjectContainer.js:6</code></a> </p> </div> <div class="description"> </div> </div> </div> <div id="classdocs" class="tabview"> <ul class="api-class-tabs"> <li class="api-class-tab index"><a href="#index">Index</a></li> <li class="api-class-tab methods"><a href="#methods">Methods</a></li> <li class="api-class-tab properties"><a href="#properties">Properties</a></li> </ul> <div> <div id="index" class="api-class-tabpanel index"> <h2 class="off-left">Item Index</h2> <div class="index-section methods"> <h3>Methods</h3> <ul class="index-list methods extends"> <li class="index-item method"> <a href="#method_addChild">addChild</a> </li> <li class="index-item method"> <a href="#method_addChildAt">addChildAt</a> </li> <li class="index-item method inherited"> <a href="#method_click">click</a> </li> <li class="index-item method inherited"> <a href="#method_mousedown">mousedown</a> </li> <li class="index-item method inherited"> <a href="#method_mouseout">mouseout</a> </li> <li class="index-item method inherited"> <a href="#method_mouseover">mouseover</a> </li> <li class="index-item method inherited"> <a href="#method_mouseup">mouseup</a> </li> <li class="index-item method inherited"> <a href="#method_mouseupoutside">mouseupoutside</a> </li> <li class="index-item method"> <a href="#method_removeChild">removeChild</a> </li> <li class="index-item method inherited"> <a href="#method_setInteractive">setInteractive</a> </li> <li class="index-item method inherited"> <a href="#method_tap">tap</a> </li> <li class="index-item method inherited"> <a href="#method_touchend">touchend</a> </li> <li class="index-item method inherited"> <a href="#method_touchendoutside">touchendoutside</a> </li> <li class="index-item method inherited"> <a href="#method_touchstart">touchstart</a> </li> </ul> </div> <div class="index-section properties"> <h3>Properties</h3> <ul class="index-list properties extends"> <li class="index-item property inherited"> <a href="#property_alpha">alpha</a> </li> <li class="index-item property"> <a href="#property_children">children</a> </li> <li class="index-item property inherited"> <a href="#property_hitArea">hitArea</a> </li> <li class="index-item property inherited"> <a href="#property_parent">parent</a> </li> <li class="index-item property inherited"> <a href="#property_position">position</a> </li> <li class="index-item property inherited"> <a href="#property_rotation">rotation</a> </li> <li class="index-item property inherited"> <a href="#property_scale">scale</a> </li> <li class="index-item property inherited"> <a href="#property_stage">stage</a> </li> <li class="index-item property inherited"> <a href="#property_visible">visible</a> </li> </ul> </div> </div> <div id="methods" class="api-class-tabpanel"> <h2 class="off-left">Methods</h2> <div id="method_addChild" class="method item"> <h3 class="name"><code>addChild</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>DisplayObject</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p> Defined in <a href="../files/src_pixi_DisplayObjectContainer.js.html#l29"><code>src/pixi/DisplayObjectContainer.js:29</code></a> </p> </div> <div class="description"> <p>Adds a child to the container.</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">DisplayObject</code> <span class="type"><a href="../classes/DisplayObject.html" class="crosslink">DisplayObject</a></span> <div class="param-description"> </div> </li> </ul> </div> </div> <div id="method_addChildAt" class="method item"> <h3 class="name"><code>addChildAt</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>DisplayObject</code> </li> <li class="arg"> <code>index</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p> Defined in <a href="../files/src_pixi_DisplayObjectContainer.js.html#l51"><code>src/pixi/DisplayObjectContainer.js:51</code></a> </p> </div> <div class="description"> <p>Adds a child to the container at a specified index. If the index is out of bounds an error will be thrown</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">DisplayObject</code> <span class="type"><a href="../classes/DisplayObject.html" class="crosslink">DisplayObject</a></span> <div class="param-description"> </div> </li> <li class="param"> <code class="param-name">index</code> <span class="type">Number</span> <div class="param-description"> </div> </li> </ul> </div> </div> <div id="method_click" class="method item inherited"> <h3 class="name"><code>click</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>interactionData</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#method_click">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l91"><code>src/pixi/DisplayObject.js:91</code></a> </p> </div> <div class="description"> <p>A callback that is used when the users clicks on the displayObject with their mouse</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">interactionData</code> <span class="type"><a href="../classes/InteractionData.html" class="crosslink">InteractionData</a></span> <div class="param-description"> </div> </li> </ul> </div> </div> <div id="method_mousedown" class="method item inherited"> <h3 class="name"><code>mousedown</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>interactionData</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#method_mousedown">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l97"><code>src/pixi/DisplayObject.js:97</code></a> </p> </div> <div class="description"> <p>A callback that is used when the user clicks the mouse down over the sprite</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">interactionData</code> <span class="type"><a href="../classes/InteractionData.html" class="crosslink">InteractionData</a></span> <div class="param-description"> </div> </li> </ul> </div> </div> <div id="method_mouseout" class="method item inherited"> <h3 class="name"><code>mouseout</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>interactionData</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#method_mouseout">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l123"><code>src/pixi/DisplayObject.js:123</code></a> </p> </div> <div class="description"> <p>A callback that is used when the users mouse leaves the displayObject</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">interactionData</code> <span class="type"><a href="../classes/InteractionData.html" class="crosslink">InteractionData</a></span> <div class="param-description"> </div> </li> </ul> </div> </div> <div id="method_mouseover" class="method item inherited"> <h3 class="name"><code>mouseover</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>interactionData</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#method_mouseover">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l117"><code>src/pixi/DisplayObject.js:117</code></a> </p> </div> <div class="description"> <p>A callback that is used when the users mouse rolls over the displayObject</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">interactionData</code> <span class="type"><a href="../classes/InteractionData.html" class="crosslink">InteractionData</a></span> <div class="param-description"> </div> </li> </ul> </div> </div> <div id="method_mouseup" class="method item inherited"> <h3 class="name"><code>mouseup</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>interactionData</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#method_mouseup">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l103"><code>src/pixi/DisplayObject.js:103</code></a> </p> </div> <div class="description"> <p>A callback that is used when the user releases the mouse that was over the displayObject for this callback to be fired the mouse must have been pressed down over the displayObject</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">interactionData</code> <span class="type"><a href="../classes/InteractionData.html" class="crosslink">InteractionData</a></span> <div class="param-description"> </div> </li> </ul> </div> </div> <div id="method_mouseupoutside" class="method item inherited"> <h3 class="name"><code>mouseupoutside</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>interactionData</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#method_mouseupoutside">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l110"><code>src/pixi/DisplayObject.js:110</code></a> </p> </div> <div class="description"> <p>A callback that is used when the user releases the mouse that was over the displayObject but is no longer over the displayObject for this callback to be fired, The touch must have started over the displayObject</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">interactionData</code> <span class="type"><a href="../classes/InteractionData.html" class="crosslink">InteractionData</a></span> <div class="param-description"> </div> </li> </ul> </div> </div> <div id="method_removeChild" class="method item"> <h3 class="name"><code>removeChild</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>DisplayObject</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p> Defined in <a href="../files/src_pixi_DisplayObjectContainer.js.html#l97"><code>src/pixi/DisplayObjectContainer.js:97</code></a> </p> </div> <div class="description"> <p>Removes a child from the container.</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">DisplayObject</code> <span class="type"><a href="../classes/DisplayObject.html" class="crosslink">DisplayObject</a></span> <div class="param-description"> </div> </li> </ul> </div> </div> <div id="method_setInteractive" class="method item inherited"> <h3 class="name"><code>setInteractive</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>interactive</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#method_setInteractive">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l164"><code>src/pixi/DisplayObject.js:164</code></a> </p> </div> <div class="description"> <p>Indicates if the sprite will have touch and mouse interactivity. It is false by default</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">interactive</code> <span class="type">Boolean</span> <div class="param-description"> </div> </li> </ul> </div> </div> <div id="method_tap" class="method item inherited"> <h3 class="name"><code>tap</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>interactionData</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#method_tap">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l134"><code>src/pixi/DisplayObject.js:134</code></a> </p> </div> <div class="description"> <p>A callback that is used when the users taps on the sprite with their finger basically a touch version of click</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">interactionData</code> <span class="type"><a href="../classes/InteractionData.html" class="crosslink">InteractionData</a></span> <div class="param-description"> </div> </li> </ul> </div> </div> <div id="method_touchend" class="method item inherited"> <h3 class="name"><code>touchend</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>interactionData</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#method_touchend">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l147"><code>src/pixi/DisplayObject.js:147</code></a> </p> </div> <div class="description"> <p>A callback that is used when the user releases a touch over the displayObject</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">interactionData</code> <span class="type"><a href="../classes/InteractionData.html" class="crosslink">InteractionData</a></span> <div class="param-description"> </div> </li> </ul> </div> </div> <div id="method_touchendoutside" class="method item inherited"> <h3 class="name"><code>touchendoutside</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>interactionData</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#method_touchendoutside">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l153"><code>src/pixi/DisplayObject.js:153</code></a> </p> </div> <div class="description"> <p>A callback that is used when the user releases the touch that was over the displayObject for this callback to be fired, The touch must have started over the sprite</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">interactionData</code> <span class="type"><a href="../classes/InteractionData.html" class="crosslink">InteractionData</a></span> <div class="param-description"> </div> </li> </ul> </div> </div> <div id="method_touchstart" class="method item inherited"> <h3 class="name"><code>touchstart</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>interactionData</code> </li> </ul><span class="paren">)</span> </div> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#method_touchstart">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l141"><code>src/pixi/DisplayObject.js:141</code></a> </p> </div> <div class="description"> <p>A callback that is used when the user touch's over the displayObject</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">interactionData</code> <span class="type"><a href="../classes/InteractionData.html" class="crosslink">InteractionData</a></span> <div class="param-description"> </div> </li> </ul> </div> </div> </div> <div id="properties" class="api-class-tabpanel"> <h2 class="off-left">Properties</h2> <div id="property_alpha" class="property item inherited"> <h3 class="name"><code>alpha</code></h3> <span class="type">Number</span> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#property_alpha">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l33"><code>src/pixi/DisplayObject.js:33</code></a> </p> </div> <div class="description"> <p>The opacity of the object.</p> </div> </div> <div id="property_children" class="property item"> <h3 class="name"><code>children</code></h3> <span class="type">Array</span> <div class="meta"> <p> Defined in <a href="../files/src_pixi_DisplayObjectContainer.js.html#l16"><code>src/pixi/DisplayObjectContainer.js:16</code></a> </p> </div> <div class="description"> <p>[read-only] The of children of this container.</p> </div> </div> <div id="property_hitArea" class="property item inherited"> <h3 class="name"><code>hitArea</code></h3> <span class="type"><a href="../classes/Rectangle.html" class="crosslink">Rectangle</a></span> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#property_hitArea">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l62"><code>src/pixi/DisplayObject.js:62</code></a> </p> </div> <div class="description"> <p>This is the defined area that will pick up mouse / touch events. It is null by default. Setting it is a neat way of optimising the hitTest function that the interactionManager will use (as it will not need to hit test all the children)</p> </div> </div> <div id="property_parent" class="property item inherited"> <h3 class="name"><code>parent</code></h3> <span class="type"><a href="../classes/DisplayObjectContainer.html" class="crosslink">DisplayObjectContainer</a></span> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#property_parent">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l48"><code>src/pixi/DisplayObject.js:48</code></a> </p> </div> <div class="description"> <p>[read-only] The display object container that contains this display object.</p> </div> </div> <div id="property_position" class="property item inherited"> <h3 class="name"><code>position</code></h3> <span class="type"><a href="../classes/Point.html" class="crosslink">Point</a></span> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#property_position">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l12"><code>src/pixi/DisplayObject.js:12</code></a> </p> </div> <div class="description"> <p>The coordinate of the object relative to the local coordinates of the parent.</p> </div> </div> <div id="property_rotation" class="property item inherited"> <h3 class="name"><code>rotation</code></h3> <span class="type">Number</span> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#property_rotation">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l26"><code>src/pixi/DisplayObject.js:26</code></a> </p> </div> <div class="description"> <p>The rotation of the object in radians.</p> </div> </div> <div id="property_scale" class="property item inherited"> <h3 class="name"><code>scale</code></h3> <span class="type"><a href="../classes/Point.html" class="crosslink">Point</a></span> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#property_scale">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l19"><code>src/pixi/DisplayObject.js:19</code></a> </p> </div> <div class="description"> <p>The scale factor of the object.</p> </div> </div> <div id="property_stage" class="property item inherited"> <h3 class="name"><code>stage</code></h3> <span class="type"><a href="../classes/Stage.html" class="crosslink">Stage</a></span> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#property_stage">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l55"><code>src/pixi/DisplayObject.js:55</code></a> </p> </div> <div class="description"> <p>[read-only] The stage the display object is connected to, or undefined if it is not connected to the stage.</p> </div> </div> <div id="property_visible" class="property item inherited"> <h3 class="name"><code>visible</code></h3> <span class="type">Boolean</span> <div class="meta"> <p>Inherited from <a href="../classes/DisplayObject.html#property_visible">DisplayObject</a>: <a href="../files/src_pixi_DisplayObject.js.html#l40"><code>src/pixi/DisplayObject.js:40</code></a> </p> </div> <div class="description"> <p>The visibility of the object.</p> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> <script src="../assets/vendor/prettify/prettify-min.js"></script> <script>prettyPrint();</script> <script src="../assets/js/yui-prettify.js"></script> <script src="../assets/../api.js"></script> <script src="../assets/js/api-filter.js"></script> <script src="../assets/js/api-list.js"></script> <script src="../assets/js/api-search.js"></script> <script src="../assets/js/apidocs.js"></script> </body> </html>