MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE, Reference

Page: 473 / 1378

CustomActions 473
list (CustomActions.list method)
public static list() : Array
Returns an Array object containing the names of all the custom actions that are registered
with the Flash authoring tool. The elements of the array are simple names, without the .xml
file extension, and without any directory separators (for example, ":", "/", or "\"). If there are
no registered custom actions,
list()
returns a zero-length array. If an error occurs,
list()
returns the value
undefined
.
Availability: ActionScript 1.0; Flash Player 6
Returns
Array
- An array.
Example
The following example lists the custom actions in a ComboBox instance, and gets the custom
action when a Button instance is clicked. Drag an instance of a ComboBox, Button, and
TextArea onto the Stage. Give the ComboBox an instance name of
customActionName_cb
,
the TextArea an instance name of
customActionXml_ta
, and the Button an instance name of
view_button
. Enter the following ActionScript on Frame 1 of the Timeline:
import mx.controls.*;
var customActionName_cb:ComboBox;
var customActionXml_ta:TextArea;
var view_button:Button;
customActionName_cb.dataProvider = CustomActions.list();
customActionXml_ta.editable = false;
var viewListener:Object = new Object();
viewListener.click = function(evt:Object) {
var caName:String = String(customActionName_cb.selectedItem);
customActionXml_ta.text = CustomActions.get(caName);
};
view_button.addEventListener("click", viewListener);