F > FCheckBox (component)

 

FCheckBox (component)

The CheckBox component in the Flash authoring environment provides drag-and-drop functionality for adding check boxes to Flash documents; it also provides a user interface for setting basic parameters. The methods of the FCheckBox component allow you to control check boxes at runtime: you can create check boxes, control check boxes created in authoring, set or override basic parameters, and set additional runtime options. You do not need to use a constructor to access the methods of components.

The CheckBox component is supported by Flash Player 6.

Component methods do not perform error checking for type, as do other native ActionScript objects and actions; therefore, it is recommended that you validate parameters before passing them to methods.

For information on using the CheckBox component, setting parameters during authoring, and changing the color and appearance of components, see Customizing component colors and text and Customizing component skins in the Using Components chapter of Using Flash.

 
Method summary for the FCheckBox component

Method

Description

FCheckBox.getEnabled

Returns true if the check box is enabled, false if it is disabled.

FCheckBox.getLabel

Returns the label applied to the check box as a string.

FCheckBox.getValue

Returns true if the check box is selected, false if it is not selected.

FCheckBox.registerSkinElement

Registers a skin element to a property.

FCheckBox.setChangeHandler

Specifies a change handler to call when the value of the check box changes.

FCheckBox.setEnabled

Determines whether the check box is enabled or disabled.

FCheckBox.setLabel

Specifies text for the label of the check box.

FCheckBox.setLabelPlacement

Specifies whether the label appears to the left or right of the check box.

FCheckBox.setSize

Sets the width of the check box, in pixels, and redraws it.

FCheckBox.setStyleProperty

Sets a single style property for a component.

FCheckBox.setValue

Selects or deselects the check box and triggers the change handler function.