Dynamically adding paragraphs to a Spark RichText control in Flex 4

The following example shows how you can dynamically add paragraphs to a TextFlow in a Spark RichText control by creating a new SpanElement (<span/>) and ParagraphElement (<p/>) object and then adding the spans and paragraphs to the textFlow object using the addChild() method.

Full code after the jump.

The following example(s) require Flash Player 10 and the Adobe Flex 4 SDK. To download the Adobe Flash Builder 4 trial, see www.adobe.com/products/flex/. To download the latest nightly build of the Flex 4 SDK, see opensource.adobe.com/wiki/display/flexsdk/Download+Flex+4.

For more information on getting started with Flex 4 and Flash Builder 4, see the official Adobe Flex Team blog.

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2009/10/09/dynamically-adding-paragraphs-to-a-spark-richtext-control-in-flex-4/ -->
<s:Application name="Spark_RichText_textFlow_addChild_test"
        xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/halo">
    <s:controlBarContent>
        <s:Button id="btn"
                label="Add paragraph"
                click="btn_clickHandler(event);" />
    </s:controlBarContent>
 
    <fx:Script>
        <![CDATA[
            import flash.text.engine.FontWeight;
            import flashx.textLayout.elements.ParagraphElement;
            import flashx.textLayout.elements.SpanElement;
 
            protected function btn_clickHandler(evt:MouseEvent):void {
                var span1:SpanElement = new SpanElement();
                span1.fontWeight = FontWeight.BOLD;
                span1.text = new Date().toDateString() + ': ';
 
                var span2:SpanElement = new SpanElement();
                span2.text = new Date().toTimeString();
 
                var para:ParagraphElement = new ParagraphElement();
                para.addChild(span1);
                para.addChild(span2);
 
                rchTxt.textFlow.addChild(para);
            }
        ]]>
    </fx:Script>
 
    <s:Scroller height="100" horizontalCenter="0" verticalCenter="0">
        <s:Group width="100%" height="100%">
            <s:RichText id="rchTxt">
                <s:textFlow>
                    <s:TextFlow />
                </s:textFlow>
            </s:RichText>
        </s:Group>
    </s:Scroller>
 
</s:Application>

This entry is based on a beta version of the Flex 4 SDK and therefore is very likely to change as development of the Flex SDK continues. The API can (and will) change causing examples to possibly not compile in newer versions of the Flex 4 SDK.