      *    <li>The first item if <code>requireSelection</code> = <code>true</code> 
      *      and there is at least one item.</li>
      *  </ul>
+     *
+     *  <p>When the user changes the <code>selectedItem</code> property by interacting with the control,
+     *  the control dispatches the <code>change</code> and <code>changing</code> events. 
+     *  When you change the value of the <code>selectedItem</code> property programmatically,
+     *  it dispatches the <code>valueCommit</code> event.</p>
      *
      *  @default undefined
      *  

     *     and there is at least one item.</li>
     *  </ul>
     *
     *  @default -1
     *  
     *  @langversion 3.0

 *  Dispatched when the selection is going to change. 
 *  Calling the <code>preventDefault()</code> method
 *  on the event prevents the selection from changing.
 *  
 *  <p>This event is dispatched when the user interacts with the control.
 *  When you change the value of the <code>selectedIndex</code> 
 *  or <code>selectedItem</code> properties programmatically, 
 *  the control does not dispatch the <code>changing</code> event. 
 *  It dispatches the <code>valueCommit</code> event instead.</p>
 *
 *  @eventType spark.events.IndexChangeEvent.CHANGING
 *  
