Package	mx.controls
Class	public class ButtonBar
Inheritance	ButtonBar NavBar Box Container UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
Implements	IFocusManagerComponent
Subclasses	ToggleButtonBar

A push button is one that does not remember its selected state when selected. The typical use for a push button in a button bar is for grouping a set of related buttons together, which gives them a common look and navigation, and handling the logic for the click event in a single place.

The ButtonBar control creates Button controls based on the value of its dataProvider property. Even though ButtonBar is a subclass of Container, do not use methods such as Container.addChild() and Container.removeChild() to add or remove Button controls. Instead, use methods such as addItem() and removeItem() to manipulate the dataProvider property. The ButtonBar control automatically adds or removes the necessary children based on changes to the dataProvider property.

To control the styling of the buttons of the ButtonBar control, use the buttonStyleName, firstButtonStyleName, and lastButtonStyleName style properties; do not try to style the individual Button controls that make up the ButtonBar control.

You can use the ToggleButtonBar control to define a group of toggle buttons.

Show MXML Syntax

Hide MXML Syntax

  <mx:ButtonBar
    Styles
    buttonHeight="undefined"
    buttonStyleName="Name of CSS style declaration, which specifies
    styles for the buttons"
    buttonWidth="undefined"
    firstButtonStyleName="The value of buttonStyleName"
    focusAlpha="0.5"
    focusRoundedCorners="tl tr bl br"
    horizontalAlign="center|left|right"
    horizontalGap="0"
    lastButtonStyleName="The value of buttonStyleName"
    verticalAlign="middle|top|bottom"
    verticalGap="0"
     
    Events
    itemClick="No default"
    >
    ...
       child tags
    ...
  </mx:ButtonBar>
  

Default MXML PropertydataProvider

View the examples.

See also