Setting the border weight on a Spark Border container in Flex 4

The following example shows how you can set the border weight on a Spark Border container in Flex 4 by setting the borderWeight style.

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/09/28/setting-the-border-weight-on-a-spark-border-container-in-flex-4/ -->
<s:Application name="Spark_Border_borderWeight_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>
        <mx:Form>
            <mx:FormItem label="borderWeight:">
                <s:HSlider id="slider" />
            </mx:FormItem>
        </mx:Form>
    </s:controlBarContent>
 
    <s:Border id="brdr"
              borderWeight="{slider.value}"
              horizontalCenter="0" verticalCenter="0"
              width="90%" height="90%">
        <s:RichText fontSize="72" width="100%" height="100%">
            <s:p>The quick brown fox jumps over the lazy dog.</s:p>
        </s:RichText>
    </s:Border>
 
</s:Application>

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

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2009/09/28/setting-the-border-weight-on-a-spark-border-container-in-flex-4/ -->
<s:Application name="Spark_Border_borderWeight_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">
 
    <fx:Style>
        @namespace s "library://ns.adobe.com/flex/spark";
        @namespace mx "library://ns.adobe.com/flex/halo";
 
        s|Border {
            borderWeight: 10;
        }
    </fx:Style>
 
    <s:Border id="brdr"
              horizontalCenter="0" verticalCenter="0"
              width="90%" height="90%">
        <s:RichText fontSize="72" width="100%" height="100%">
            <s:p>The quick brown fox jumps over the lazy dog.</s:p>
        </s:RichText>
    </s:Border>
 
</s:Application>

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

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2009/09/28/setting-the-border-weight-on-a-spark-border-container-in-flex-4/ -->
<s:Application name="Spark_Border_borderWeight_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>
        <mx:Form>
            <mx:FormItem label="borderWeight:">
                <s:HSlider id="slider"
                           change="slider_change(event);" />
            </mx:FormItem>
        </mx:Form>
    </s:controlBarContent>
 
    <fx:Script>
        <![CDATA[
            protected function slider_change(evt:Event):void {
                brdr.setStyle("borderWeight", slider.value);
            }
        ]]>
    </fx:Script>
 
    <s:Border id="brdr"
              horizontalCenter="0" verticalCenter="0"
              width="90%" height="90%">
        <s:RichText fontSize="72" width="100%" height="100%">
            <s:p>The quick brown fox jumps over the lazy dog.</s:p>
        </s:RichText>
    </s:Border>
 
</s:Application>

If you are using a custom border stroke object (for example, if you set the borderStroke property and are using a custom SolidColorStroke, LinearGradientStroke, or RadialGradientStroke object) you’ll need to set the weight property on the stroke instead of setting the borderWeight style on the border, as seen in the following example:

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2009/09/28/setting-the-border-weight-on-a-spark-border-container-in-flex-4/ -->
<s:Application name="Spark_Border_borderWeight_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:Border id="brdr"
              horizontalCenter="0" verticalCenter="0"
              width="90%" height="90%">
        <s:borderStroke>
            <s:LinearGradientStroke weight="10">
                <s:GradientEntry color="red" />
                <s:GradientEntry color="white" />
                <s:GradientEntry color="blue" />
            </s:LinearGradientStroke>
        </s:borderStroke>
        <s:RichText fontSize="72" width="100%" height="100%">
            <s:p>The quick brown fox jumps over the lazy dog.</s:p>
        </s:RichText>
    </s:Border>
 
</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.

One thought on “Setting the border weight on a Spark Border container in Flex 4

  1. it is good to learn.
    thanks for making this type of site.

    hava a nice day .
    bye.
    i am also eager to know about how to learn flex3 in easy way.
    please tell me a good suggestion.
    thank u

Comments are closed.