     
     /**
      *  Removes a visual element from the specified index position 
-     *  in the visual container.
+     *  in the container.
+     *  The index positions of any elements 
+     *  above the element in this visual container are decreased by 1.
      *
      *  @param index The index of the element to remove.
      *
-     *  @return The element removed from the visual container.
+     *  @return The element removed.
      * 
      *  @throws RangeError If the index does not exist in the child list.
      *  

    //----------------------------------
    
    /**
     *  Adds a visual element to this visual container. The element is 
     *  added after all other elements.  It will sit on top of all other 
     *  elements unless the layer property is set.  
     *  (To add a visual element to a specific index position, use 
     *  the <code>addElementAt()</code> method.)
     * 
     *  <p>If you add a visual element object that already has a different
     *  container as a parent, the element is removed from the child 
     *  list of the other container.</p>  
     *
     *  @param element The element to add as a child of this visual container.
     *
     *  @return The element that was added to the visual container.
     * 
     *  @event elementAdded ElementExistenceChangedEvent Dispatched when 
     *  the element is added to the child list.
     * 
     *  @throws ArgumentError If the element is the same as the visual container.
     *  
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 1.5
     *  @productversion Flex 4
     */   
    function addElement(element:IVisualElement):IVisualElement;
    
    /**
     *  Adds a visual element to this visual container. The element is 
     *  added at the index position specified.  An index of 0 represents   
     *  the first element and the back (bottom) of the display list, unless
     *  <code>layer</code> is specified.
     * 
     *  <p>If you add a visual element object that already has a different
     *  container as a parent, the element is removed from the child 
     *  list of the other container.</p>  
     *
     *  @param element The element to add as a child of this visual container.
     * 
     *  @param index The index position to which the element is added. If 
     *  you specify a currently occupied index position, the child object 
     *  that exists at that position and all higher positions are moved 
     *  up one position in the child list.
     *
     *  @return The element that was added to the visual container.
     * 
     *  @event elementAdded ElementExistenceChangedEvent Dispatched when 
     *  the element is added to the child list.
     * 
     *  @throws ArgumentError If the element is the same as the visual container.
     * 
     *  @throws RangeError If the index position does not exist in the child list.
     *  



/**
 *  The IVisualElementContainer interface defines the minimum properties and methods 
 *  required for a container to manage Spark components for display.
 *
 *  <p>Note that the Spark SkinnableDataContainer and DataGroup containers 
 *  do not implement this interface. 
 *  Those containers manage their 
 *  children through the <code>dataProvider</code> property.</p>
 *
 *  @see mx.core.IVisualElement
 *  
 *  @langversion 3.0
 *  @playerversion Flash 10
