     //
     //--------------------------------------------------------------------------
     
-    /*
-     *  TODO: description of how single selection properties
-     *  work when multiple selection is enabled. multiple selection
-     *  doesn't support selectionChanging event. etc.
-     *  
-     *  @langversion 3.0
-     *  @playerversion Flash 10
-     *  @playerversion AIR 1.5
-     *  @productversion Flex 4
-     */
-    /**
-     *  <code>true</code> if the list supports multiple selection.
-     * 
+    //----------------------------------
+    //  allowMultipleSelection
+    //----------------------------------
+    
+    private var _allowMultipleSelection:Boolean = false;
+    
+    /**
+     *  Boolean flag controlling whether multiple selection
+     *  is enabled or not. 
+     *
      *  @default false
      *  
      *  @langversion 3.0

     */
    override public function isItemIndexSelected(index:int):Boolean
    {
        if (allowMultipleSelection)
            return selectedIndices.indexOf(index) != -1;
        
        return index == selectedIndex;

     *  @playerversion AIR 1.5
     *  @productversion Flex 4
     */
    public function get allowMultipleSelection():Boolean
    {
        return _allowMultipleSelection;
    }
    
    /**
     *  @private
     */
    public function set allowMultipleSelection(value:Boolean):void
    {
    	if (value == _allowMultipleSelection)
    		return 
    		
    	_allowMultipleSelection = true;
    }
    
    //----------------------------------
    //  selectedIndex
