Customizing the RadioButton component

You can transform a RadioButton component horizontally and vertically both while authoring and at runtime. While authoring, select the component on the Stage and use the Free Transform tool or any of the Modify > Transform commands. At runtime, use the setSize() method (see UIObject.setSize()).

The bounding box of a RadioButton component is invisible and also designates the hit area for the component. If you increase the size of the component, you also increase the size of the hit area.

If the component's bounding box is too small to fit the component label, the label clips to fit.

Using styles with the RadioButton component

You can set style properties to change the appearance of a RadioButton. If the name of a style property ends in "Color", it is a color style property and behaves differently than non-color style properties. For more information, see Using styles to customize component color and text.

A RadioButton component uses the following Halo styles:

Style	Description
`themeColor`	The background of a component. This is the only color style that doesn't inherit its value. Possible values are "haloGreen", "haloBlue", and "haloOrange".
`color`	The text of a component label.
`disabledColor`	The disabled color for text.
`fontFamily`	The font name for text.
`fontSize`	The point size for the font.
`fontStyle`	The font style; either "normal", or "italic".
`fontWeight`	The font weight; either "normal", or "bold".

Using skins with the RadioButton component

The RadioButton component can be skinned while authoring by modifying the component's symbols in the library. The skins for the RadioButton component are located in the following folder in the library of HaloTheme.fla or SampleTheme.fla: Flash UI Components 2/Themes/MMDefault/RadioButton Assets/States. See About skinning components.

If a radio button is enabled and unselected, it displays its roll-over state when a user moves the pointer over it. When a user clicks an unselected radio button, the radio button receives input focus and displays its false pressed state. When a user releases the mouse, the radio button displays its true state and the previously selected radio button within the group returns to its false state. If a user moves the pointer off a radio button while pressing the mouse, the radio button's appearance returns to its false state and it retains input focus.

If a radio button or radio button group is disabled it displays its disabled state, regardless of user interaction.

If you use the UIObject.createClassObject() method to create a RadioButton component instance dynamically, you can also skin the component dynamically. To skin a RadioButton component dynamically, pass skin properties to the UIObject.createClassObject() method. For more information, see About skinning components. The skin properties indicate which symbol to use to display a component.

A RadioButton component uses the following skin properties:

Name	Description
`falseUpIcon`	The unchecked state. The default value is `radioButtonFalseUp`.
`falseDownIcon`	The pressed-unchecked state. The default value is `radioButtonFalseDown`.
`falseOverIcon`	The over-unchecked state. The default value is `radioButtonFalseOver`.
`falseDisabledIcon`	The disabled-unchecked state. The default value is `radioButtonFalseDisabled`.
`trueUpIcon`	The checked state. The default value is `radioButtonTrueUp`.
`trueDisabledIcon`	The disabled-checked state. The default value is `radioButtonTrueDisabled`.