MACROMEDIA FLEX-FLEX ACTIONSCRIPT LANGUAGE Reference page 398

SharedObject class
Availability
Flash Player 6.
Description
Shared objects are powerful: They offer real-time data sharing between objects that are persistent
on the user's computer. You can consider local shared objects as cookies.
You can use local shared objects to maintain local persistence. For example, you can call
SharedObject.getLocal()
player. Because the shared object is locally persistent, Flash saves its data attributes on the user's
computer when the SWF file ends. The next time the SWF file runs, the calculator will display
the values it had when the SWF file ended. Alternatively, if you set the shared object's properties
to before the SWF file ends, the calculator opens without any prior values the next time the
null
SWF file runs.
To create a local shared object, use the following syntax:
// Create a local shared object
var so:SharedObject = SharedObject.getLocal("foo");
Local disk space considerations
Local shared objects are always persistent on the client, depending on available memory and disk
space.
By default, Flash can save locally persistent remote shared objects as large as 100K. When you try
to save a larger object, Flash Player shows the Local Storage dialog box, which lets the user allow
or deny local storage for the domain that is requesting access. (Ensure that your Flex screen size is
at least 215 x 138 pixels; this is the minimum size Flash requires to display the dialog box.)
If the user clicks Allow, the object is saved and
property of
SharedObject.Flush.Success
SharedObject.onStatus
The user can also specify permanent local storage settings for a particular domain by right-
clicking (Windows) or Control-clicking (Macintosh) while a SWF file is running, selecting
Settings, and then opening the Local Storage panel.
You can't use ActionScript to specify local storage settings for a user, but you can display the Local
Storage panel for the user by using
The following list summarizes how the user's disk space choices interact with shared objects:
•
If the user selects Never, objects are not saved locally and all
commands issued for the object return
•
If the user selects Unlimited (moves the slider all the way to the right), objects are saved locally,
as available disk space allows.
398 Chapter 6: ActionScript Core Classes
to create a shared object, such as a calculator with memory, in the
SharedObject.onStatus
; if the user clicks Deny, the object is not saved and
is invoked with a
code
System.showSettings(1)
.
false
ActionScript Core Classes
property of
SharedObject.Flush.Failed
.
SharedObject.flush()
CHAPTER 6
is invoked with a
code
.