Gumbo FxTextArea - Functional and Design Specification

package mx.components
{

public class FxTextArea extends FxTextBase
{
    //--------------------------------------------------------------------------
    //
    //  Constructor
    //
    //--------------------------------------------------------------------------

    /**
     *  Constructor.
     */
    public function FxTextArea()

    //--------------------------------------------------------------------------
    //
    //  Properties
    //
    //--------------------------------------------------------------------------

    //----------------------------------
    //  content
    //----------------------------------

    /**
     *  The textual information displayed in the TextArea.
     *
     *  You can set this property to four different things:
     *  <ul>
     *    <li>A String containing markup.</li>
     *    <li>An Array containing a Strings and FlowElements.
     *    <li>A XML instance representing a TextFlow.</li>
     *    <li>A TextFlow instance.</li>
     *  </ul>
     *  But whenever you get this property, it will be a TextFlow instance.
     */
    public function get content():Object
    public function set content(value:Object):void

    //----------------------------------
    //  heightInLines
    //----------------------------------

    /**
     *  The default height for the TextArea, measured in lines.
     *  The TextArea's formatting styles -- such as lineHeight
     *  and fontSize -- are used to determined the line height.
     *  This property is used to calculate the TextArea's measuredHeight;
     *  the measuredHeight is not determined from the text
     *  or formats in the content.
     *  It will be ignored if you specify an explicit height
     *  or a percent height.
     *
     *  @default 10
     */
    public function get heightInLines():int
    public function set heightInLines(value:int):void

    //----------------------------------
    //  horizontalScrollPolicy
    //----------------------------------

    /**
     *  See horizontalScrollPolicy for FxScroller
     */
    public function get horizontalScrollPolicy():String
    public function set horizontalScrollPolicy(value:String):void

    //----------------------------------
    //  verticalScrollPolicy
    //----------------------------------

    /**
     *  See verticalScrollPolicy for FxScroller.
     */
    public function get verticalScrollPolicy():String
    public function set verticalScrollPolicy(value:String):void
    
    //----------------------------------
    //  widthInChars
    //----------------------------------
	
    /**
     *  The default width for the TextInput, measured in characters.
     *  The width of the "0" character is used for the calculation,
     *  since in most fonts the digits all have the same width.
     *  So if you set this property to 5, it will be wide enough
     *  to let the user enter 5 digits.
     *
     *  @default
     */
    public function get widthInChars():int
    public function set widthInChars(value:int):void

    //--------------------------------------------------------------------------
    //
    //  Methods
    //
    //--------------------------------------------------------------------------

    /**
     *  Returns an Object containing name/value pairs of text formats
     *  for the selected character range.
     *  If a format is not consistently set across the entire range,
     *  its value will be null.
     *  You can specify an Array containing names of the formats
     *  that you want returned; if you don't, all formats will be returned.
     *  For example, calling
     *  <code>getSelectionFormat([ "fontSize", "color" ])</code>
     *  might return <code>({ fontSize: 12, color: null })</code>
     *  if the selection is uniformly 12-point but has multiple colors.
     *  The supported formats are those in the interfaces
     *  ICharacterFormats, IParagraphFormats, and IContainerFormats.
     */
    public function getSelectionFormat(names:Array = null):Object

    /**
     *  Applies a set of name/value pairs of text formats
     *  to the selected character range.
     *  A value of null does not get applied.
     *  For example, calling
     *  <code>setAttributes({ fontSize: 12, color: 0xFF0000 })</code>
     *  will set the fontSize and color of the selection.
     *  The supported attributes are those in the interfaces
     *  ICharacterFormats, IParagraphFormats, and IContainerFormats.
     */
    public function setSelectionFormat(format:Object):void

    /**
     *  Exports the TextView's content as XML with a <TextFlow> root tag.
     */
    public function export():XML
}

}

<FxTextArea widthInChars="200" heightInLines="20" fontSize="10"/>