Creating a resizing ToolBar in Flex

by Peter deHaan on January 6, 2008

in Repeater, ToolBar

The following example shows how you can create a toolbar in Flex by using the ToolBar container which automatically wraps and re-lays out its children when the toolbar is resized. According to the documentation in the class file (see [SDK Directory]\frameworks\projects\framework\src\mx\controls\richTextEditorClasses\ToolBar.as):

The ToolBar container lays out its children in a single horizontal row. If the width of the container is less than the measured width, the children wrap to the next line.
While wrapping, any VRule controls (separators) at the end of a row or the beginning of a row are not drawn.

Full code after the jump.

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/01/06/creating-a-resizing-toolbar-in-flex/ -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
        layout="vertical"
        verticalAlign="top"
        backgroundColor="white">

    <mx:Array id="images">
        <mx:Object label="Button" />
        <mx:Object label="ButtonBar" />
        <mx:Object label="CheckBox" />
        <mx:Object label="ColorPicker" />
        <mx:Object label="ComboBox" />
        <mx:Object label="DataGrid" />
        <mx:Object label="DateChooser" />
        <mx:Object label="DateField" />
        <mx:Object label="HorizontalList" />
        <mx:Object label="HRule" />
        <mx:Object label="HSlider" />
        <mx:Object label="Image" />
        <mx:Object label="Label" />
        <mx:Object label="LinkBar" />
        <mx:Object label="LinkButton" />
        <mx:Object label="List" />
        <mx:Object label="Menu" />
        <mx:Object label="MenuBar" />
        <mx:Object label="NumericStepper" />
        <mx:Object label="ProgressBar" />
        <mx:Object label="RadioButton" />
        <mx:Object label="RadioButtonGroup" />
        <mx:Object label="RichTextEditor" />
        <mx:Object label="Spacer" />
        <mx:Object label="SWFLoader" />
        <mx:Object label="TabBar" />
        <mx:Object label="Text" />
        <mx:Object label="TextArea" />
        <mx:Object label="TextInput" />
        <mx:Object label="TileList" />
        <mx:Object label="Tree" />
        <mx:Object label="VideoDisplay" />
        <mx:Object label="VRule" />
        <mx:Object label="VScrollBar" />
        <mx:Object label="VSlider" />
    </mx:Array>

    <mx:ApplicationControlBar dock="true">
        <mx:Form styleName="plain">
            <mx:FormItem label="percentWidth:">
                <mx:HSlider id="slider"
                        minimum="0"
                        maximum="100"
                        value="35"
                        liveDragging="true"
                        snapInterval="1"
                        tickInterval="10"
                        dataTipPrecision="0" />
            </mx:FormItem>
        </mx:Form>
    </mx:ApplicationControlBar>

    <mx:VBox id="vBox"
            verticalAlign="middle"
            horizontalAlign="center"
            backgroundColor="black"
            backgroundAlpha="0.1"
            width="100%"
            height="200">
        <mx:ToolBar id="toolBar"
                 percentWidth="{slider.value}"
                 backgroundColor="haloSilver"
                 minWidth="18">
            <mx:Repeater id="imgRepeater"
                    dataProvider="{images}">
                <mx:Image id="img"
                        source="assets/{imgRepeater.currentItem.label}.png"
                        toolTip="{imgRepeater.currentItem.label}" />
            </mx:Repeater>
        </mx:ToolBar>
    </mx:VBox>

</mx:Application>

View source is enabled in the following example.

{ 9 comments… read them below or add one }

1 Tianzhen Lin January 24, 2008 at 5:09 pm

It seems that the ToolBar class is now marked as [ExcludeClass], so it cannot be directly accessed through MXML interface. A simple workaround would be creating a class that inherits ToolBar class, then use the new class as the control.

Reply

2 rconceiver March 22, 2008 at 1:03 am

hi peter
thats really a nice example…
can we resize the shape with mouse i mean like transform tool?

Reply

3 Ryan Stawarz July 11, 2008 at 12:15 pm

Any idea on how to make an ApplicationControlBar accomplish the same thing? I have an ApplicationControlBar that when my window is resized, the content does not wrap to the next line. thoughts? any help would be appreciated

Reply

4 peterd July 11, 2008 at 12:35 pm

Ryan Stawarz,

Does something like the following work?

<?xml version="1.0" encoding="utf-8"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:ApplicationControlBar dock="true">
        <mx:ToolBar width="100%">
            <mx:Button width="300" />
            <mx:Button width="300" />
            <mx:Button width="300" />
            <mx:Button width="300" />
            <mx:Button width="300" />
            <mx:Button width="300" />
        </mx:ToolBar>
    </mx:ApplicationControlBar>

</mx:Application>

Peter

Reply

5 Ryan Stawarz July 11, 2008 at 1:47 pm

yes… turns out that my applicationcontrol bar was given a height of 50 via a style, and hence it didn’t work so well.

One thing that scares me though is the lack of Documentation of the mx:ToolBar component… where does this component live? I can’t find it in the AS3 documentation (http://livedocs.adobe.com/flex/3/langref/index.html)… is ToolBar something I should be using – or is Adobe going to yank it from me just when I need it most?

Reply

6 peterd July 11, 2008 at 3:32 pm

Ryan Stawarz,

I’m not sure if the ToolBar container is officially supported or not. It is currently used by the RichTextEditor control to handle the button layouts. You could file a bug/enhancement request at http://bugs.adobe.com/flex/ and post the bug number here so a few people can vote/subscribe to the issue.

Peter

Reply

7 Matt Chotin July 14, 2008 at 3:01 pm

Hi,

The ToolBar is not an officially support component, but I don’t see it changing much if at all in the next release.

Matt
Adobe

Reply

8 Parker Ault April 22, 2009 at 8:31 pm

Adobe seems to have completely buried this in FB3, here’s a link to the source if you want to see how it works:

http://opensource.adobe.com/svn/opensource/flex/sdk/trunk/frameworks/projects/framework/src/mx/controls/richTextEditorClasses/ToolBar.as

Reply

9 Connor Garvey July 16, 2009 at 9:24 am

This is perfect. I’ve been screwing around with the mx:Tile and flexlib:FlowLayout containers, which don’t resize properly. Your solution saved me. Thank you!

Reply

Leave a Comment

Sorry, this blog is terrible at eating HTML comments.
If you're pasting any HTML/XML/MXML code, you need to convert your < characters to &lt; and your > characters to &gt; .

You can use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong> <pre lang="" line="" escaped="">

Anti-Spam Protection by WP-SpamFree

Previous post:

Next post: