      }
     
     /**
-     *  Removes the current selection.
+     *  If <code>requireSelection</code> is false, removes the current
+     *  selection.
      * 
      *  @return true if the selection is changed.
      * 

     */
    public function removeAll():Boolean
    {
        var selectionChanged:Boolean = removeSelection() || selectAllFlag;
        selectAllFlag = false;        
        return selectionChanged;
    }
            
    //----------------------------------

            return;
        
        _requireSelection = value;
             
        if (_requireSelection)
            ensureRequiredSelection();
    }

    //----------------------------------
