Adobe 38039927 - Fireworks CS3 - PC Extended User Manual page 269

ADOBE FIREWORKS CS3 265
Extending Guide
that could be used maliciously are not permitted in remote procedure calls (including all methods of the File object,
see "Files object" on page 14 and the functions and ). The RPC server returns an invalid
fw.launchApp fw.findApp
method error to the client if it attempts to use these methods or properties. Finally, clients can release only those
objects that have been retained on their behalf. Additionally, when a client disconnects, all the server objects that
have been retained on that client's behalf are released.
Note: Objects are not destroyed until the client releases them or until the client that created them disconnects from the
server.
RPCMethods class
To use remote procedure calls, Flash developers need to create an instance of a Fireworks object and thereafter
manage Fireworks objects carefully to save memory. In ActionScript, you should create blocks of code where you
will access the Fireworks DOM, assign a group (pool) of objects to variables, and then release those objects when
you are finished. Fireworks provides the following series of memory-management functions to support Action-
Script developers working with Fireworks objects. To learn more about using these functions, see "Creating auto-
release blocks" on page 266 and "Accessing proxy objects" on page 267. These functions are defined in the supporting
RPCMethods.as stubs file available for download from the Adobe website at
www.adobe.com/go/fireworks_documentation.
Note: ActionScript remote procedure calls for Fireworks are not ActionScript 1 compatible, and must be written in
ActionScript 2.0 (using Flash MX 2004 or later).
RPCMethods.CreateAutoReleasePool()
Usage
RPCMethods.CreateAutoReleasePool()
Arguments
None.
Returns
Nothing.
Description
Starts the auto-release block.
RPCMethods.DestroyAutoReleasePool()
Usage
RPCMethods.DestroyAutoReleasePool()
Arguments
None.
Returns
Nothing.
Description
Ends the auto-release block and frees all allocated remote objects in the current auto-release block function.