RadioButton class

Inheritance UIObject > UIComponent > SimpleButton > Button > RadioButton

ActionScript Package Name mx.controls.RadioButton

The properties of the RadioButton class allow you at runtime to create a text label and position it in relation to the radio button. You can also assign data values to radio buttons, assign them to groups, and select them based on data value or instance name.

Setting a property of the RadioButton class with ActionScript overrides the parameter of the same name set in the Property inspector or Component Inspector panel.

The RadioButton component uses the FocusManager to override the default Flash Player focus rectangle and draw a custom focus rectangle with rounded corners. For information about creating focus navigation, see Creating custom focus navigation.

Each component class has a version property which is a class property. Class properties are only available on the class itself. The version property returns a string that indicates the version of the component. To access the version property, use the following code:

trace(mx.controls.RadioButton.version);

Note: The following code returns undefined: trace(myRadioButtonInstance.version);.

Method summary for the RadioButton class

Inherits all methods from UIObject class, UIComponent class, SimpleButton, and Button class.

Property summary for the RadioButton class

Property

Description

RadioButton.data

The value associated with a radio button instance.

RadioButton.groupName

The group name for a radio button group or radio button instance.

RadioButton.label

The text that appears next to a radio button.

RadioButton.labelPlacement

The orientation of the label text in relation to a radio button.

RadioButton.selected

Sets the state of the radio button instance to selected and deselects the previously selected radio button.

RadioButton.selectedData

Selects the radio button in a radio button group with the specified data value.

RadioButton.selection

A reference to the currently selected radio button in a radio button group.

Inherits all properties from UIObject class, UIComponent class, SimpleButton, and the Button class

Event summary for the RadioButton class

Event

Description

RadioButton.click

Triggered when the mouse is pressed over a button instance.

Inherits all events from UIObject class, UIComponent class, SimpleButton, and Button class