Flash CS3 Documentation

ActionScript 2.0 Components Language Reference > Button component > Button.label

Button.label

Availability

Flash Player 6 (6.0.79.0).

Edition

Flash MX 2004.

Usage

buttonInstance.label

Description

Property; specifies the text label for a button instance. By default, the label appears centered on the button. Calling this method overrides the label authoring parameter specified in the Property inspector or the Component inspector. The default value is "Button".

Example

With a button on the Stage with instance name my_button, the following code sets the label to "Test Button":

my_button.label = "Test Button";

You can also create the button and assign the label entirely in ActionScript using the method UIObject.createClassObject(). First drag the Button component from the Components panel to the current document's library, so the component appears in the library, but not on the Stage. Then, in the first frame of the main timeline, add the following ActionScript:

this.createClassObject(mx.controls.Button, "my_button", 1, {label: "Test Button"});

See also

Button.labelPlacement

Flash CS3