  *  invalidation/measurement/layout, enabling/disabling, tooltips, and IME
  *  (Input Method Editor) support for entering Chinese, Japanese, and
  *  Korean text.</p>
+ * 
+ *  <p>Warning: if UITextField inherits <code>layoutDirection="rtl"</code>, it 
+ *  will modify its own <code>transform.matrix</code> to restore the default
+ *  coordinate system locally.</p>
  *
  *  @see flash.text.TextField
  *  @see mx.core.UITextFormat

        styleChangedFlag = false;
        invalidateDisplayListFlag = false;
    }

    /**
     *  Returns the TextFormat object that represents 
     *  character formatting information for this UITextField object.

     *  @private
     */
    private var untruncatedText:String;
    
    /**
     *  @private
     *  True if we've inherited layoutDirection="rtl".  
     */
    private var mirror:Boolean = false;

    //--------------------------------------------------------------------------
    //
    //  Overridden properties
    //
    //--------------------------------------------------------------------------
    
    //----------------------------------
    //  x
    //----------------------------------
    
    private var _x:Number = 0;
    
    /**
     *  @private
     */
    override public function set x(value:Number):void
    {
        _x = value;
        super.x = value;
        if (mirror)
            validateTransformMatrix();
    }
    
    /**
     *  @private
     */
    override public function get x():Number
    {
        // FIXME(hmuller): by default get x returns transform.matrix.tx rounded to the nearest 20th.
        // should do the same here, if we're returning _x.
        return (mirror) ? _x : super.x;
    }
    
    //----------------------------------
    //  width
    //----------------------------------
    
    /**
     *  @private
     */
    override public function set width(value:Number):void  
    {
        super.width = value;
        if (mirror)
            validateTransformMatrix();
    }
    
    //----------------------------------
    //  htmlText
