Adobe Extending Flash Professional CS4 - Manual (Page 45)

23 EXTENDING FLASH CS4 PROFESSIONAL
Top-Level Functions and Methods
Parameters
None.
Returns
Nothing.
Description
Function; called when the extensible tool is active and the user changes its options in the Property inspector. You can
use the
tools.activeTool property to query the current values of the options (see tools.activeTool ).
Example
The following example displays a message in the Output panel when the extensible tool is active and the user changes
its options in the Property inspector.
function notifySettingsChanged() {
var theTool = fl.tools.activeTool;
var newValue = theTool.myProp;
}
prompt()
Availability
Flash MX 2004.
Usage
prompt(promptMsg [,text])
Parameters
promptMsg A string to display in the Prompt dialog box (limited to 256 characters in Mac OS X).
text An optional string to display as a default value for the text field.
Returns
The string the user typed if the user clicks OK;
null if the user clicks Cancel.
Description
Method; displays a prompt and optional text in a modal Alert dialog box, along with OK and Cancel buttons.
Example
The following example prompts the user to enter a user name. If the user types a name and clicks OK, the name appears
in the Output panel.
var userName = prompt("Enter user name", "Type user name here");
fl.trace(userName);
See also
alert() , confirm()