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 [...]]]> The following example shows you how to draw an ellipse in a Flex Gumbo application using the new Ellipse graphic primitive in FXG.

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/10/30/using-graphical-and-text-primitives-in-flex-gumbo/ -->
<FxApplication name="FXG_test"
        xmlns="http://ns.adobe.com/mxml/2009">
    <layout>
        <BasicLayout />
    </layout>

    <Ellipse id="ellipse"
            width="100"
            height="100"
            horizontalCenter="0"
            verticalCenter="0">
        <fill>
            <SolidColor color="red" />
        </fill>
    </Ellipse>

</FxApplication>

View source is enabled in the following example.

You could also create a custom component from the Ellipse with the FXG namespace, as seen in the following example:

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/10/30/using-graphical-and-text-primitives-in-flex-gumbo/ -->
<FxApplication name="FXG_test"
        xmlns="http://ns.adobe.com/mxml/2009"
        xmlns:comps="comps.*">
    <layout>
        <BasicLayout />
    </layout>

    <comps:RedEllipse id="ellipse"
            horizontalCenter="0"
            verticalCenter="0" />

</FxApplication>

comps/RedEllipse.fxg

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/10/30/using-graphical-and-text-primitives-in-flex-gumbo/ -->
<Ellipse xmlns="http://ns.adobe.com/fxg/2008"
        width="100"
        height="100">
    <fill>
        <SolidColor color="red" />
    </fill>
</Ellipse>

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/10/30/using-graphical-and-text-primitives-in-flex-gumbo/ -->
<FxApplication name="FXG_test"
        xmlns="http://ns.adobe.com/mxml/2009"
        initialize="init();">
    <layout>
        <BasicLayout />
    </layout>

    <Script>
        <![CDATA[
            import mx.graphics.Ellipse;
            import mx.graphics.SolidColor;

            private var ellipse:Ellipse;

            private function init():void {
                ellipse = new Ellipse();
                ellipse.fill = new SolidColor(0xFF0000);
                ellipse.width = 100;
                ellipse.height = 100;
                ellipse.horizontalCenter = 0;
                ellipse.verticalCenter = 0;
                addItem(ellipse);
            }
        ]]>
    </Script>

</FxApplication>

However, if you were using the <Application /> tag instead of the <FxApplication /> tag, the syntax is slightly different.
First, if you tried to use an Ellipse graphic primitive as a direct child of a Halo container (Application, Panel, Canvas, etc.), you would currently get a compiler error saying the following:

‘Ellipse’ declaration must be contained within the <Declarations> tag since it does not implement mx.core.IUIComponent.

To get around this you need to wrap the Ellipse (or other graphic primitives such as BitmapGraphic, Path, Rect, TextGraphic, TextBox, etc) in within a Group class instance (or one of its subclasses such as HGroup, VGroup, Graphic, MXMLComponent, or Skin).

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/10/30/using-graphical-and-text-primitives-in-flex-gumbo/ -->
<Application name="FXG_test"
        xmlns="http://ns.adobe.com/mxml/2009"
        layout="absolute"
        backgroundColor="white">

    <Group id="group"
            horizontalCenter="0"
            verticalCenter="0">
        <Ellipse id="ellipse"
                width="100"
                height="100">
            <fill>
                <SolidColor color="red" />
            </fill>
        </Ellipse>
    </Group>

</Application>

You could also create a custom component from the Ellipse with the FXG namespace, as seen in the following example:

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/10/30/using-graphical-and-text-primitives-in-flex-gumbo/ -->
<Application name="FXG_test"
        xmlns="http://ns.adobe.com/mxml/2009"
        xmlns:comps="comps.*"
        layout="absolute"
        backgroundColor="white">

    <Group id="group"
            horizontalCenter="0"
            verticalCenter="0">
        <comps:RedEllipse id="ellipse" />
    </Group>

</Application>

comps/RedEllipse.fxg

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/10/30/using-graphical-and-text-primitives-in-flex-gumbo/ -->
<Ellipse xmlns="http://ns.adobe.com/fxg/2008"
        width="100"
        height="100">
    <fill>
        <SolidColor color="red" />
    </fill>
</Ellipse>

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/10/30/using-graphical-and-text-primitives-in-flex-gumbo/ -->
<Application name="FXG_test"
        xmlns="http://ns.adobe.com/mxml/2009"
        layout="absolute"
        backgroundColor="white"
        initialize="init();">

    <Script>
        <![CDATA[
            import mx.components.Group;
            import mx.graphics.Ellipse;
            import mx.graphics.SolidColor;

            private var group:Group;
            private var ellipse:Ellipse;

            private function init():void {
                ellipse = new Ellipse();
                ellipse.fill = new SolidColor(0xFF0000);
                ellipse.width = 100;
                ellipse.height = 100;

                group = new Group();
                group.setStyle("horizontalCenter", 0);
                group.setStyle("verticalCenter", 0);
                group.addItem(ellipse);
                addChild(group);
            }
        ]]>
    </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.

For more information see the FXG 1.0 Specification page at opensource.adobe.com.

 

Full code after the jump.

View MXML

Full code after the jump.

View [...]]]> The following example shows how you can alternate background row colors in a LineSeries chart in Flex by setting the horizontalAlternateFill style in the GridLines object, as seen in the following snippet:

<mx:LineChart showDataTips="true" dataProvider="{dp}">

    <mx:backgroundElements>
        <mx:GridLines>
            <mx:horizontalAlternateFill>
                <mx:SolidColor color="haloSilver" alpha="0.25" />
            </mx:horizontalAlternateFill>
        </mx:GridLines>
    </mx:backgroundElements>

</mx:LineChart>

View MXML

<?xml version="1.0"?>
<!-- http://blog.flexexamples.com/2007/11/15/alternating-background-row-colors-in-a-flex-lineseries-chart/ -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
        layout="vertical"
        verticalAlign="middle"
        backgroundColor="white">

    <mx:XMLListCollection id="dp">
        <mx:source>
            <mx:XMLList>
                <quote date="8/27/2007" open="40.38" close="40.81" />
                <quote date="8/24/2007" open="40.5" close="40.41" />
                <quote date="8/23/2007" open="40.82" close="40.6" />
                <quote date="8/22/2007" open="40.4" close="40.77" />
                <quote date="8/21/2007" open="40.41" close="40.13" />
                <quote date="8/20/2007" open="40.55" close="40.74" />
                <quote date="8/17/2007" open="40.18" close="40.32" />
                <quote date="8/16/2007" open="39.83" close="39.96" />
                <quote date="8/15/2007" open="40.22" close="40.18" />
                <quote date="8/14/2007" open="41.01" close="40.41" />
                <quote date="8/13/2007" open="41" close="40.83" />
                <quote date="8/10/2007" open="41.3" close="41.06" />
                <quote date="8/9/2007" open="39.9" close="40.75" />
                <quote date="8/8/2007" open="39.61" close="40.23" />
                <quote date="8/7/2007" open="39.08" close="39.42" />
                <quote date="8/6/2007" open="38.71" close="39.38" />
                <quote date="8/3/2007" open="39.47" close="38.75" />
                <quote date="8/2/2007" open="39.4" close="39.52" />
                <quote date="8/1/2007" open="40.29" close="39.58" />
            </mx:XMLList>
        </mx:source>
    </mx:XMLListCollection>

    <mx:LineChart id="lineChart"
            showDataTips="true"
            dataProvider="{dp}"
            width="100%"
            height="100%">

        <mx:backgroundElements>
            <mx:GridLines>
                <mx:horizontalAlternateFill>
                    <mx:SolidColor color="haloSilver" alpha="0.25" />
                </mx:horizontalAlternateFill>
            </mx:GridLines>
        </mx:backgroundElements>

        <!-- vertical axis -->
        <mx:verticalAxis>
            <mx:LinearAxis baseAtZero="false" title="Price" />
        </mx:verticalAxis>

        <!-- horizontal axis -->
        <mx:horizontalAxis>
            <mx:CategoryAxis id="ca" categoryField="@date" title="Date" />
        </mx:horizontalAxis>

        <!-- horizontal axis renderer -->
        <mx:horizontalAxisRenderers>
            <mx:AxisRenderer axis="{ca}" canDropLabels="true" />
        </mx:horizontalAxisRenderers>

        <!-- series -->
        <mx:series>
            <mx:LineSeries yField="@open" form="curve" displayName="Open" />
        </mx:series>
    </mx:LineChart>

</mx:Application>

View source is enabled in the following example.

You can also change the horizontalAlternateFill style using CSS, as seen in the following snippet.

<mx:Style>
    GridLines {
        horizontalAlternateFill: haloSilver;
    }
</mx:Style>

Note that when using CSS, you set the horizontalAlternateFill style to a color name, not a SolidColor object.

If you want to change the horizontalAlternateFill style using ActionScript, you can use one of the following snippets:

myGridLines.setStyle("horizontalAlternateFill", "haloSilver");

import mx.graphics.SolidColor;
...
var solidColor:SolidColor = new SolidColor(0xFF0000, 0.2);
myGridLines.setStyle("horizontalAlternateFill", solidColor);

Note that you must pass a numeric value to the SolidColor constructor (or the SolidColor instance’s color property). If you want to use a named color (such as “red”, or “haloSilver”), you can use the static StyleManager.getColorName() method, as seen in the following snippet:

import mx.graphics.SolidColor;
import mx.styles.StyleManager;
...
var colorAsNumber:uint = StyleManager.getColorName("haloBlue");
var solidColor:SolidColor = new SolidColor(colorAsNumber, 0.1);
myGridLines.setStyle("horizontalAlternateFill", solidColor);

You can also alternate row colors using the horizontalFill style, or use both the horizontalFill and horizontalAlternateFill styles to set the fill colors for both odd and even rows, as seen in the following snippet:

<mx:backgroundElements>
    <mx:GridLines direction="both">
        <mx:horizontalFill>
            <mx:SolidColor color="haloBlue" />
        </mx:horizontalFill>
        <mx:horizontalAlternateFill>
            <mx:SolidColor color="haloSilver" />
        </mx:horizontalAlternateFill>
    </mx:GridLines>
</mx:backgroundElements>

The following example shows how you can alternate the row colors for even and odd numbered rows by setting both the horizontalFill and horizontalAlternateFill styles using MXML:

View MXML

<?xml version="1.0"?>
<!-- http://blog.flexexamples.com/2007/11/15/alternating-background-row-colors-in-a-flex-lineseries-chart/ -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
        layout="vertical"
        verticalAlign="middle"
        backgroundColor="white">

    <mx:XMLListCollection id="dp">
        <mx:source>
            <mx:XMLList>
                <quote date="8/27/2007" open="40.38" close="40.81" />
                <quote date="8/24/2007" open="40.5" close="40.41" />
                <quote date="8/23/2007" open="40.82" close="40.6" />
                <quote date="8/22/2007" open="40.4" close="40.77" />
                <quote date="8/21/2007" open="40.41" close="40.13" />
                <quote date="8/20/2007" open="40.55" close="40.74" />
                <quote date="8/17/2007" open="40.18" close="40.32" />
                <quote date="8/16/2007" open="39.83" close="39.96" />
                <quote date="8/15/2007" open="40.22" close="40.18" />
                <quote date="8/14/2007" open="41.01" close="40.41" />
                <quote date="8/13/2007" open="41" close="40.83" />
                <quote date="8/10/2007" open="41.3" close="41.06" />
                <quote date="8/9/2007" open="39.9" close="40.75" />
                <quote date="8/8/2007" open="39.61" close="40.23" />
                <quote date="8/7/2007" open="39.08" close="39.42" />
                <quote date="8/6/2007" open="38.71" close="39.38" />
                <quote date="8/3/2007" open="39.47" close="38.75" />
                <quote date="8/2/2007" open="39.4" close="39.52" />
                <quote date="8/1/2007" open="40.29" close="39.58" />
            </mx:XMLList>
        </mx:source>
    </mx:XMLListCollection>

    <mx:LineChart id="lineChart"
            showDataTips="true"
            dataProvider="{dp}"
            width="100%"
            height="100%">

        <mx:backgroundElements>
            <mx:GridLines direction="both">
                <mx:horizontalFill>
                    <mx:SolidColor color="haloBlue" alpha="0.6" />
                </mx:horizontalFill>
                <mx:horizontalAlternateFill>
                    <mx:SolidColor color="haloSilver" alpha="0.6" />
                </mx:horizontalAlternateFill>
            </mx:GridLines>
        </mx:backgroundElements>

        <!-- vertical axis -->
        <mx:verticalAxis>
            <mx:LinearAxis baseAtZero="false" title="Price" />
        </mx:verticalAxis>

        <!-- horizontal axis -->
        <mx:horizontalAxis>
            <mx:CategoryAxis id="ca" categoryField="@date" title="Date" />
        </mx:horizontalAxis>

        <!-- horizontal axis renderer -->
        <mx:horizontalAxisRenderers>
            <mx:AxisRenderer axis="{ca}" canDropLabels="true" />
        </mx:horizontalAxisRenderers>

        <!-- series -->
        <mx:series>
            <mx:LineSeries yField="@open" form="curve" displayName="Open" />
        </mx:series>
    </mx:LineChart>

</mx:Application>

View source is enabled in the following example.

 

Full [...]]]> The following example shows how you can create transparent wedges in a Flex PieChart control by setting the SolidColor object’s alpha property to 0, as seen in the following snippet:

<mx:PieChart dataProvider="{arrColl}" height="100%" width="100%">
    <mx:series>
        <mx:PieSeries id="pieSeries" field="data">
            <mx:fills>
                <mx:SolidColor alpha="0.0" />
                <mx:SolidColor color="haloBlue" alpha="1.0" />
            </mx:fills>
            <mx:filters>
                <mx:Array />
            </mx:filters>
        </mx:PieSeries>
    </mx:series>
</mx:PieChart>

Full code after the jump.

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2007/11/11/drawing-transparent-pie-wedges-in-a-flex-piechart-control/ -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
        layout="vertical"
        verticalAlign="middle"
        backgroundColor="white">

    <mx:ArrayCollection id="arrColl">
        <mx:source>
            <mx:Array>
                <mx:Object label="Product 1" data="4" />
                <mx:Object label="Product 2" data="27" />
            </mx:Array>
        </mx:source>
    </mx:ArrayCollection>

    <mx:PieChart id="pieChart"
            dataProvider="{arrColl}"
            height="100%"
            width="100%"
            showDataTips="true">
        <mx:series>
            <mx:PieSeries id="pieSeries"
                    field="data">
                <mx:fills>
                    <mx:SolidColor alpha="0.0" />
                    <mx:SolidColor color="haloBlue" alpha="1.0" />
                </mx:fills>
                <mx:filters>
                    <mx:Array />
                </mx:filters>
            </mx:PieSeries>
        </mx:series>
    </mx:PieChart>

</mx:Application>

View source is enabled in the following example.

 

Full code after the jump.

The first example shows how you can set the fills style directly in your MXML code. As you can see, you pass [...]]]> The following examples show how you can change the default fill colors for a Flex PieChart control by setting the fills style using either CSS or MXML.

Full code after the jump.

The first example shows how you can set the fills style directly in your MXML code. As you can see, you pass an array of SolidColor objects containing color and alpha properties. If the color property is not specified, the default color of black is used. If you don’t pass a value for the alpha property, a default value of 1.0 (fully visible) is used.

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2007/11/11/changing-the-default-fill-colors-in-a-flex-piechart-control/ -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
        layout="horizontal"
        verticalAlign="middle"
        backgroundColor="white">

    <mx:XML id="dp">
        <products>
            <product label="Product 1" data="3" />
            <product label="Product 2" data="1" />
            <product label="Product 3" data="4" />
            <product label="Product 4" data="1" />
            <product label="Product 5" data="5" />
            <product label="Product 6" data="9" />
            <product label="Product 7" data="2" />
        </products>
    </mx:XML>

    <mx:PieChart id="pieChart"
            dataProvider="{dp.product}"
            showDataTips="true"
            height="100%"
            width="100%">
        <mx:series>
            <mx:PieSeries id="pieSeries"
                    field="@data"
                    labelPosition="callout">
                <mx:fills>
                       <mx:SolidColor color="red" alpha="1.0" />
                       <mx:SolidColor color="haloOrange" alpha="1.0" />
                       <mx:SolidColor color="yellow" alpha="1.0" />
                       <mx:SolidColor color="haloGreen" alpha="1.0" />
                       <mx:SolidColor color="haloBlue" alpha="1.0" />
                </mx:fills>
                <mx:filters>
                    <mx:Array />
                </mx:filters>
            </mx:PieSeries>
        </mx:series>
    </mx:PieChart>

</mx:Application>

View source is enabled in the following example.

The following example shows how you can set the fills style within your style sheet (which can either be within the <mx:Style /> block, or loaded in from an external *.css file). When using CSS, you only specify the color value, and an alpha value of 1.0 is automatically set.

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2007/11/11/changing-the-default-fill-colors-in-a-flex-piechart-control/ -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
        layout="vertical"
        verticalAlign="middle"
        backgroundColor="white">

    <mx:Style>
        PieSeries {
            fills: red, haloOrange, yellow, haloGreen, haloBlue;
        }
    </mx:Style>

    <mx:XML id="dp">
        <products>
            <product label="Product 1" data="3" />
            <product label="Product 2" data="1" />
            <product label="Product 3" data="4" />
            <product label="Product 4" data="1" />
            <product label="Product 5" data="5" />
            <product label="Product 6" data="9" />
            <product label="Product 7" data="2" />
        </products>
    </mx:XML>

    <mx:PieChart id="pieChart"
            dataProvider="{dp.product}"
            showDataTips="true"
            height="100%"
            width="100%">
        <mx:series>
            <mx:PieSeries id="pieSeries"
                    field="@data"
                    labelPosition="callout">
                <mx:filters>
                    <mx:Array />
                </mx:filters>
            </mx:PieSeries>
        </mx:series>
    </mx:PieChart>

</mx:Application>

View source is enabled in the following example.

Defaults? Did somebody say something about defaults?
If you’re curious (you probably weren’t, but hey), here are the default fill colors for the PieChart control:

View source is enabled in the following example.

 

Full code after the jump.

The following example shows how you can set fill colors in a Flex PieChart by specifying a custom fill function. In this example the fill function calculates the fill color based on the percentage value of each item. The larger the wedge, the brigher the fill color.

View MXML

<?xml version="1.0"?>
<!-- http://blog.flexexamples.com/2007/11/07/creating-custom-fills-in-a-flex-piechart-control-using-the-fillfunction-property/ -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
        layout="vertical"
        verticalAlign="middle"
        backgroundColor="white">

    <mx:Script>
        <![CDATA[
            import mx.charts.series.items.PieSeriesItem;
            import mx.graphics.IFill;
            import mx.charts.ChartItem;
            import mx.graphics.SolidColor;

            private function pieSeries_fillFunc(item:ChartItem, index:Number):IFill {
                var curItem:PieSeriesItem = PieSeriesItem(item);
                /* Convert to a number between 0 and 1. */
                var pct:Number = curItem.percentValue / 100;
                return new SolidColor(0x0000FF * pct, 1.0);
            }
        ]]>
    </mx:Script>

    <mx:XML id="dp">
        <products>
            <product label="Product 1" data="3" />
            <product label="Product 2" data="1" />
            <product label="Product 3" data="4" />
            <product label="Product 4" data="1" />
            <product label="Product 5" data="5" />
            <product label="Product 6" data="9" />
        </products>
    </mx:XML>

    <mx:PieChart id="chart"
            height="100%"
            width="100%"
            showDataTips="true"
            dataProvider="{dp.product}">
        <mx:series>
            <mx:PieSeries id="series"
                    nameField="@label"
                    field="@data"
                    fillFunction="pieSeries_fillFunc"
                    filters="[]" />
        </mx:series>
    </mx:PieChart>

</mx:Application>

View source is enabled in the following example.