MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT, Reference Manual

Page: 620 / 816

620 Chapter 12: ActionScript Dictionary
To create “private” values for a shared object—values that are available only to the client instance
while the object is in use and are not stored with the object when it is closed—create properties
that are not named
data
to store them, as shown in the following example.
so.favoriteColor = "blue";
so.favoriteNightClub = "The Bluenote Tavern";
so.favoriteSong = "My World is Blue";
Example
The following example sets the current stream to the user’s selection.
curStream = _root.so.data.msgList[selected].streamName;
See also
Sound class
SharedObject.flush()
Availability
Flash Player 6.
Usage
myLocalSharedObject .flush([ minimumDiskSpace ])
Parameters
minimumDiskSpace
An optional integer specifying the number of bytes that must be allotted
for this object. The default value is 0.
Returns
A Boolean value of
true
or
false
, or a string value of
"pending"
.
•
If the user has permitted local information storage for objects from this domain, and the
amount of space allotted is sufficient to store the object, this method returns
true
. (If you have
passed a value for
minimumDiskSpace
, the amount of space allotted must be at least equal to
that value for
true
to be returned).
•
If the user has permitted local information storage for objects from this domain, but the
amount of space allotted is not sufficient to store the object, this method returns
"pending"
.
•
If the user has permanently denied local information storage for objects from this domain, or if
Flash is unable to save the object for any reason, this method returns
false
.
Description
Method; immediately writes a locally persistent shared object to a local file. If you don’t use this
method, Flash writes the shared object to a file when the shared object session ends—that is,
when the SWF file is closed, when the shared object is garbage-collected because it no longer has
any references to it, or when you call
SharedObject.data
.