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 http://www.adobe.com/products/flex/. To download the latest nightly build of the Flex 4 SDK, see http://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/08/29/creating-a-spark-button-control-with-a-vertical-label-in-flex-4/ -->
<s:Application name="Spark_Button_textRotation_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:Button id="btn"
            label="Spark Button"
            skinClass="skins.CustomButtonSkin"
            horizontalCenter="0" verticalCenter="0" />
 
</s:Application>

And the custom Spark Button skin class, skins/CustomButtonSkin.mxml, is as follows:

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2009/08/29/creating-a-spark-button-control-with-a-vertical-label-in-flex-4/ -->
<s:SparkSkin name="CustomButtonSkin"
        xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        minWidth="21" minHeight="21"
        alpha.disabled="0.5">
    <!-- states -->
    <s:states>
        <s:State name="up" />
        <s:State name="over" />
        <s:State name="down" />
        <s:State name="disabled" />
    </s:states>
 
    <!-- host component -->
    <fx:Metadata>
        [HostComponent("spark.components.Button")]
    </fx:Metadata>
 
    <fx:Script>
        <![CDATA[
            /* Define the skin elements that should not be colorized. For button, the graphics are colorized but the label is not. */
            static private const exclusions:Array = ["labelDisplay"];
 
            override public function get colorizeExclusions():Array {
                return exclusions;
            }
        ]]>
    </fx:Script>
 
    <!-- layer 1: shadow -->
    <s:Rect left="-1" right="-1" top="-1" bottom="-1"
            radiusX="2" radiusY="2">
        <s:fill>
            <s:LinearGradient rotation="90">
                    <s:GradientEntry color="0x000000"
                            color.down="0xFFFFFF"
                            alpha="0.01"
                            alpha.down="0" />
                    <s:GradientEntry color="0x000000"
                            color.down="0xFFFFFF"
                            alpha="0.07"
                            alpha.down="0.5" />
            </s:LinearGradient>
        </s:fill>
    </s:Rect>
 
    <!-- layer 2: fill -->
    <s:Rect left="1" right="1" top="1" bottom="1"
            radiusX="2" radiusY="2">
        <s:fill>
            <s:LinearGradient rotation="90">
                <s:GradientEntry color="0xFFFFFF"
                        color.over="0xBBBDBD"
                        color.down="0xAAAAAA"
                        alpha="0.85" />
                <s:GradientEntry color="0xD8D8D8"
                        color.over="0x9FA0A1"
                        color.down="0x929496"
                        alpha="0.85" />
            </s:LinearGradient>
        </s:fill>
    </s:Rect>
 
    <!-- layer 3: fill lowlight -->
    <s:Rect left="1" right="1" bottom="1" height="9"
            radiusX="2" radiusY="2">
        <s:fill>
            <s:LinearGradient rotation="90">
                <s:GradientEntry color="0x000000" alpha="0.0099" />
                <s:GradientEntry color="0x000000" alpha="0.0627" />
            </s:LinearGradient>
        </s:fill>
    </s:Rect>
 
    <!-- layer 4: fill highlight -->
    <s:Rect left="1" right="1" top="1" height="9"
            radiusX="2" radiusY="2">
        <s:fill>
            <s:SolidColor color="0xFFFFFF"
                    alpha="0.33"
                    alpha.over="0.22"
                    alpha.down="0.12" />
        </s:fill>
    </s:Rect>
 
    <!-- layer 5: highlight stroke (all states except down) -->
    <s:Rect left="1" right="1" top="1" bottom="1"
            radiusX="2" radiusY="2"
            excludeFrom="down">
        <s:stroke>
            <s:LinearGradientStroke rotation="90" weight="1">
                <s:GradientEntry color="0xFFFFFF" alpha.over="0.22" />
                <s:GradientEntry color="0xD8D8D8" alpha.over="0.22" />
            </s:LinearGradientStroke>
        </s:stroke>
    </s:Rect>
 
    <!-- layer 6: highlight stroke (down state only) -->
    <s:Rect left="1" top="1" bottom="1" width="1"
            includeIn="down">
        <s:fill>
            <s:SolidColor color="0x000000" alpha="0.07" />
        </s:fill>
    </s:Rect>
    <s:Rect right="1" top="1" bottom="1" width="1"
            includeIn="down">
        <s:fill>
            <s:SolidColor color="0x000000" alpha="0.07" />
        </s:fill>
    </s:Rect>
    <s:Rect left="2" top="1" right="2" height="1"
            includeIn="down">
        <s:fill>
            <s:SolidColor color="0x000000" alpha="0.25" />
        </s:fill>
    </s:Rect>
    <s:Rect left="1" top="2" right="1" height="1"
            includeIn="down">
        <s:fill>
            <s:SolidColor color="0x000000" alpha="0.09" />
        </s:fill>
    </s:Rect>
 
    <!-- layer 7: border - put on top of the fill so it doesn't disappear when scale is less than 1 -->
    <s:Rect left="0" right="0" top="0" bottom="0"
            width="69" height="20"
            radiusX="2" radiusY="2">
        <s:stroke>
            <s:LinearGradientStroke rotation="90" weight="1">
                <s:GradientEntry color="0x000000"
                        alpha="0.5625"
                        alpha.down="0.6375" />
                <s:GradientEntry color="0x000000"
                        alpha="0.75"
                        alpha.down="0.85" />
            </s:LinearGradientStroke>
        </s:stroke>
    </s:Rect>
 
    <!-- layer 8: text -->
    <s:RichText id="labelDisplay"
            breakOpportunity="all"
            textRotation="rotate90"
            textAlign="center"
            verticalAlign="middle"
            horizontalCenter="0" verticalCenter="1"
            left="10" right="10" top="2" bottom="2" />
 
</s:SparkSkin>

View source is enabled in the following example.

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.

 

Currently, there are four possible values:

• BreakOpportunity.ALL: Treats all characters in the ContentElement object as mandatory line break opportunities. You can use this option to generate the shortest possible lines, which you can use to create text on a line or similar effects.
• BreakOpportunity.ANY: Treats any character in the ContentElement object as a line break opportunity. This value is typically used when Roman text is embedded in Asian text and it is desirable for breaks to happen in the middle of words.
• BreakOpportunity.AUTO: Bases line break opportunities on Unicode character properties. This setting implements the Unicode line breaking properties defined by the Unicode Standard Annex #14.
• BreakOpportunity.NONE: Treats no characters in the ContentElement object as line break opportunities.

Full code after the jump.

To use the following code, you must have Flash Player 10 and a Flex Gumbo SDK installed in your Flex Builder 3. For more information on downloading and installing the Gumbo SDK into Flex Builder 3, see “Using the beta Gumbo SDK in Flex Builder 3″.

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/12/05/setting-the-break-opportunity-on-an-fxtextarea-control-in-flex-gumbo/ -->
<Application name="FxTextArea_breakOpportunity_test"
        xmlns="http://ns.adobe.com/mxml/2009"
        layout="vertical"
        verticalAlign="middle"
        backgroundColor="white">

    <Script>
        import flash.text.engine.BreakOpportunity;
    </Script>

    <ApplicationControlBar dock="true">
        <Form styleName="plain">
            <FormItem label="breakOpportunity:">
                <ComboBox id="comboBox" selectedIndex="2">
                    <dataProvider>
                        <Array>
                            <String>{BreakOpportunity.ALL}</String>
                            <String>{BreakOpportunity.ANY}</String>
                            <String>{BreakOpportunity.AUTO}</String>
                            <String>{BreakOpportunity.NONE}</String>
                        </Array>
                    </dataProvider>
                </ComboBox>
            </FormItem>
        </Form>
    </ApplicationControlBar>

    <FxTextArea id="textArea"
            breakOpportunity="{comboBox.selectedItem}"
            width="400"
            height="300">
        <content><String source="data/lorem.html" /></content>
    </FxTextArea>

</Application>

View source is enabled in the following example.

You can also set the breakOpportunity style in an external .CSS file or <Style/> block, as seen in the following example:

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/12/05/setting-the-break-opportunity-on-an-fxtextarea-control-in-flex-gumbo/ -->
<Application name="FxTextArea_breakOpportunity_test"
        xmlns="http://ns.adobe.com/mxml/2009"
        layout="vertical"
        verticalAlign="middle"
        backgroundColor="white">

    <Style>
        FxTextArea {
            breakOpportunity: "any";
        }
    </Style>

    <FxTextArea id="textArea"
            width="400"
            height="300">
        <content><String source="data/lorem.html" /></content>
    </FxTextArea>

</Application>

Or, you can set the breakOpportunity style using ActionScript, as seen in the following example:

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/12/05/setting-the-break-opportunity-on-an-fxtextarea-control-in-flex-gumbo/ -->
<Application name="FxTextArea_breakOpportunity_test"
        xmlns="http://ns.adobe.com/mxml/2009"
        layout="vertical"
        verticalAlign="middle"
        backgroundColor="white">

    <Script>
        <![CDATA[
            import flash.text.engine.BreakOpportunity;
            import mx.events.ListEvent;

            private function comboBox_change(evt:ListEvent):void {
                var value:String = comboBox.selectedItem.toString();
                textArea.setStyle("breakOpportunity", value);
            }
        ]]>
    </Script>

    <ApplicationControlBar dock="true">
        <Form styleName="plain">
            <FormItem label="breakOpportunity:">
                <ComboBox id="comboBox"
                        selectedIndex="2"
                        change="comboBox_change(event);">
                    <dataProvider>
                        <Array>
                            <String>{BreakOpportunity.ALL}</String>
                            <String>{BreakOpportunity.ANY}</String>
                            <String>{BreakOpportunity.AUTO}</String>
                            <String>{BreakOpportunity.NONE}</String>
                        </Array>
                    </dataProvider>
                </ComboBox>
            </FormItem>
        </Form>
    </ApplicationControlBar>

    <FxTextArea id="textArea"
            width="400"
            height="300">
        <content><String source="data/lorem.html" /></content>
    </FxTextArea>

</Application>

Due to popular demand, here is the “same” example in a more ActionScript friendly format:

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/12/05/setting-the-break-opportunity-on-an-fxtextarea-control-in-flex-gumbo/ -->
<Application name="FxTextArea_breakOpportunity_test"
        xmlns="http://ns.adobe.com/mxml/2009"
        layout="vertical"
        verticalAlign="middle"
        backgroundColor="white"
        creationComplete="init();">

    <Script>
        <![CDATA[
            import flash.text.engine.BreakOpportunity;

            import mx.components.FxTextArea
            import mx.containers.ApplicationControlBar;
            import mx.containers.Form;
            import mx.containers.FormItem;
            import mx.controls.ComboBox;
            import mx.events.ListEvent;

            [Embed(source="data/lorem.html",
                        mimeType="application/octet-stream")]
            private const Lorem:Class;

            private var comboBox:ComboBox;
            private var textArea:FxTextArea;

            private function init():void {
                var arr:Array = [];
                arr.push(BreakOpportunity.ALL);
                arr.push(BreakOpportunity.ANY);
                arr.push(BreakOpportunity.AUTO);
                arr.push(BreakOpportunity.NONE);

                comboBox = new ComboBox();
                comboBox.dataProvider = arr;
                comboBox.selectedIndex = 2;
                comboBox.addEventListener(ListEvent.CHANGE,
                            comboBox_change);

                var formItem:FormItem = new FormItem();
                formItem.label = "breakOpportunity:";
                formItem.addChild(comboBox);

                var form:Form = new Form();
                form.styleName = "plain";
                form.addChild(formItem);

                var appControlBar:ApplicationControlBar;
                appControlBar = new ApplicationControlBar();
                appControlBar.dock = true;
                appControlBar.addChild(form);
                addChildAt(appControlBar, 0);

                textArea = new FxTextArea();
                textArea.width = 400;
                textArea.height = 300;
                textArea.content = new Lorem();
                addChild(textArea);
            }

            private function comboBox_change(evt:ListEvent):void {
                var value:String = comboBox.selectedItem.toString();
                textArea.setStyle("breakOpportunity", value);
            }
        ]]>
    </Script>

</Application>

This entry is based on a beta version of the Flex Gumbo 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 Gumbo SDK.