This property is intended for use in MXML at compile time; to get or set rich text content at runtime, use the textFlow property instead. Adobe recommends using textFlow property to get and set rich text content at runtime, because it is strongly typed as a TextFlow rather than as an Object. A TextFlow is the canonical representation for rich text content in the Text Layout Framework.

The content property is the default property for TextArea, so that you can write MXML, as the following example shows:

      <s:TextArea>Hello <s:span fontWeight="bold">World</s:span></s:TextArea>
      

This property is typed as Object because you can set it to to a String, a FlowElement, or an Array of Strings and FlowElements. In the example above, the content is a 2-element array. The first array element is the String "Hello". The second array element is a SpanElement object with the text "World" in boldface.

No matter how you specify the content, the content is converted to a TextFlow object. When you get the value of this property, you get the resulting TextFlow object.

The default height of the control, measured in lines.

The control's formatting styles, such as fontSize and lineHeight, are used to calculate the line height in pixels.

You would, for example, set this property to 5 if you want the height of the RichEditableText to be sufficient to display five lines of text.

If this property is NaN (the default), then the component's default height will be determined from the text to be displayed.

This property will be ignored if you specify an explicit height, a percent height, or both top and bottom constraints.

RichEditableText's measure() method uses widthInChars and heightInLines to determine the measuredWidth and measuredHeight. These are similar to the cols and rows of an HTML TextArea.

Since both widthInChars and heightInLines default to NaN, RichTextEditable "autosizes" by default: it starts out very small if it has no text, grows in width as you type, and grows in height when you press Enter to start a new line.

The TextFlow representing the rich text displayed by this component.

A TextFlow is the most important class in the Text Layout Framework (TLF). It is the root of a tree of FlowElements representing rich text content.

You normally create a TextFlow from TLF markup using the TextFlowUtil.importFromString() or TextFlowUtil.importFromXML() methods. Alternately, you can use TLF's TextConverter class (which can import a subset of HTML) or build a TextFlow using methods like addChild() on TextFlow.

Setting this property affects the text property and vice versa.

If you set the textFlow and get the text, the text in each paragraph will be separated by a single LF ("\n").

If you set the text to a String such as "Hello World" and get the textFlow, it will be a TextFlow containing a single ParagraphElement with a single SpanElement.

If the text contains explicit line breaks -- CR ("\r"), LF ("\n"), or CR+LF ("\r\n") -- then the content will be set to a TextFlow which contains multiple paragraphs, each with one span.

Setting this property also affects the properties specifying the control's scroll position and the text selection. It resets the horizontalScrollPosition and verticalScrollPosition to 0, and it sets the selectionAnchorPosition and selectionActivePosition to -1 to clear the selection.

To turn a TextFlow object into TLF markup, use the TextFlowUtil.export() markup.

A single TextFlow cannot be shared by multiple instances of RichEditableText. To display the same text in a second instance, you must create a second TextFlow, either by using TextFlowUtil.export() and TextFlowUtil.importFromXML() or by using the deepCopy() method on TextFlow.

The default width of the control, measured in em units.

An em is a unit of typographic measurement equal to the point size. It is not necessarily exactly the width of the "M" character, but in many fonts the "M" is about one em wide. The control's fontSize style is used, to calculate the em unit in pixels.

You would, for example, set this property to 20 if you want the width of the RichEditableText to be sufficient to display about 20 characters of text.

If this property is NaN (the default), then the component's default width will be determined from the text to be displayed.

This property will be ignored if you specify an explicit width, a percent width, or both left and right constraints.

RichEditableText's measure() method uses widthInChars and heightInLines to determine the measuredWidth and measuredHeight. These are similar to the cols and rows of an HTML TextArea.

Since both widthInChars and heightInLines default to NaN, RichTextEditable "autosizes" by default: it starts out very samll if it has no text, grows in width as you type, and grows in height when you press Enter to start a new line.

Constructor.

Returns a TextLayoutFormat object specifying the formats for the specified range of characters.

If a format is not consistently set across the entire range, its value will be undefined.

You can specify a Vector of Strings containing the names of the formats that you care about; if you don't, all formats will be computed.

If you don't specify a range, the selected range is used.

Parameters

Scrolls so that the text range is visible in the container.

Parameters

Applies the specified format to the specified range.

The supported formats are those in TextFormatLayout. A value of undefined does not get applied. If you don't specify a range, the selected range is used.

The following example sets the fontSize and color of the selection:

      var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
      textLayoutFormat.fontSize = 12;
      textLayoutFormat.color = 0xFF0000;
      myRET.setFormatOfRange(textLayoutFormat);
      

Parameters