 [IconFile("ToggleSwitch.png")]
 
 /**
- *  The Spark ToggleSwitch component is a component that can flip between
- *  a selected and non selected state. The ToggleSwitch has a <code>thumb</code>
- *  skin part that moves between the two ends of the <code>track</code> skin part,
- *  similar to a Spark <code>Slider</code>.
+ *  The Spark ToggleSwitch control defines a binary switch that 
+ *  can be in the selected or unselected state. 
+ *  The ToggleSwitch consists of a thumb skin part that moves between 
+ *  the two ends of the track skin part, similar to the Spark Slider control.
  *
- *  Clicking on the component will flip it from non-selected to selected,
- *  and vice-versa. A user can also drag the thumb along the track. When released,
- *  the thumb will move to the closest end of the track, and the <code>ToggleSwitch</code>
- *  will change to be either selected or non-selected, according to the thumb's
- *  position.
+ *  <p>Clicking anywhere in the control toggles the state. 
+ *  You can also slide the thumb along the track to change state. 
+ *  When you release the thumb, the control changes state depending on 
+ *  where you released the thumb. 
+ *  If you release the thumb when you are over 50% of the way across the track, 
+ *  the switch enters the selected state. Otherwise, it enters the unselected state.</p>
+ *
+ *  <p>The ToggleSwitch control uses the following default values for 
+ *  the unselected and selected labels: OFF (unselected) and ON (selected). 
+ *  Define a custom skin to change the labels, or to change other visual 
+ *  characteristics of the control.</p>
+ *
+ *  <p>The following skin class, defined as a subclass of 
+ *  spark.skins.mobile.ToggleSwitchSkin, changes the labels to Zero and One:</p>
+ *
+ *  <pre>
+ *  package skins
+ *  // components\mobile\skins\MyToggleSwitchSkin.as
+ *  {
+ *      import spark.skins.mobile.ToggleSwitchSkin;
+ *      
+ *      public class MyToggleSwitchSkin extends ToggleSwitchSkin
+ *      {
+ *          public function MyToggleSwitchSkin()
+ *          {
+ *              super();
+ *              // Set properties to define the labels 
+ *              // for the selected and unselected positions.
+ *              selectedLabel="One";
+ *              unselectedLabel="Zero"; 
+ *          }
+ *      }
+ *  }
+ *  </pre>
+ *
+ *  @mxml
+ *  
+ *  <p>The <code>&lt;s:ToggleSwitch&gt;</code> tag inherits all of the tag 
+ *  attributes of its superclass and adds the following tag attributes:</p>
+ *  
+ *  <pre>
+ *  &lt;s:ToggleSwitch
+ *   <strong>Properties</strong>
+ *    selected="null"
+ *    thumbPosition="null"
+ * 
+ *   <strong>Common Styles</strong>
+ *    accentColor="0x3F7FBA"
+ *    slideDuration="125"
+ * 
+ *   <strong>Mobile Styles</strong>
+ *    textShadowAlpha="0.65"
+ *    textShadowColor="0x000000"
+ *  &gt;
+ *  </pre>
  *
  *  @langversion 3.0
  *  @playerversion AIR 3

     */
    private function selectedToPosition(value:Boolean):Number 
    {
        return value ? 1.0 : 0.0;	
    }
    
    /**

    [Bindable(event="thumbPositionChanged")]
    
    /**
     *  The thumb's current position along the track.
     *  The range of value is between 0.0, unselected,
     *  and 1.0, selected.
     *  
     *  @langversion 3.0
     *  @playerversion AIR 3
