MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT - Customactions Class

CustomActions.get() 347
CustomActions class
Availability
Flash Player 6.
Description
The methods of the CustomActions class allow a SWF file playing in the Flash authoring tool to
manage any custom actions that are registered with the authoring tool. A SWF file can install and
uninstall custom actions, retrieve the XML definition of a custom action, and retrieve the list of
registered custom actions.
You can use these methods to build SWF files that are extensions of the Flash authoring tool.
Such an extension could, for example, use the Flash Application Protocol to navigate a UDDI
repository and download web services into the Actions toolbox.
Method summary for the CustomActions class
CustomActions.get()
Availability
Flash Player 6.
Usage
CustomActions.get(customActionsName)
Parameters
customActionsName
The name of the custom action definition to retrieve.
Returns
If the custom action XML definition is located, returns a string; otherwise, returns undefined.
Description
Method; reads the contents of the custom action XML definition file named
customActionsName.
The name of the definition file must be a simple filename, without the .xml file extension, and
without any directory separators (':', '/' or '\').
If the definition file specified by the
customActionsName cannot be found, a value of undefined
is returned. If the custom action XML definition specified by the customActionsName parameter
is located, it is read in its entirety and returned as a string.
Method Description
CustomActions.get() Reads the contents of a custom action XML definition file.
CustomActions.install() Installs a new custom action XML definition file.
CustomActions.list() Returns a list of all registered custom actions.
CustomActions.uninstall() Removes a custom action XML definition file.