class flash.system.System
Available on all platforms
The System class contains properties related to local settings and
* operations. Among these are settings for camers and microphones, operations
* with shared objects and the use of the Clipboard.
* Additional properties and methods are in other classes within the
* flash.system package: the Capabilities class, the IME class, and the
* Security class.
This class contains only static methods and properties. You cannot * create new instances of the System class.
Class Fields
static var freeMemory:Float
The amount of memory(in bytes) that is allocated to Adobe®
* Flash® Player or Adobe® AIR® and that
* is not in use. This unused portion of allocated memory
* (System.totalMemory
) fluctuates as garbage collection takes
* place. Use this property to monitor garbage collection.
The currently installed system IME. To register for imeComposition events,
* call addEventListener()
on this instance.
static var privateMemory:Float
The entire amount of memory(in bytes) used by an application. This is the
* amount of resident private memory for the entire process.
* AIR developers should use this property to determine the entire memory
* consumption of an application.
For Flash Player, this includes the memory used by the container * application, such as the web browser.
static var totalMemory:UInt
The amount of memory(in bytes) currently in use that has been directly
* allocated by Flash Player or AIR.
* This property does not return all memory used by an Adobe AIR
* application or by the application(such as a browser) containing Flash
* Player content. The browser or operating system may consume other memory.
* The System.privateMemory
property reflects all memory
* used by an application.
If the amount of memory allocated is greater than the maximum value for
* a uint object(uint.MAX_VALUE
, or 4,294,967,295), then this
* property is set to 0. The System.totalMemoryNumber
property
* allows larger values.
static var totalMemoryNumber:Float
The amount of memory(in bytes) currently in use that has been directly
* allocated by Flash Player or AIR.
* This property is expressed as a Number, which allows higher values than
* the System.totalMemory
property, which is of type int.
This property does not return all memory used by an Adobe AIR
* application or by the application(such as a browser) containing Flash
* Player content. The browser or operating system may consume other memory.
* The System.privateMemory
property reflects all memory
* used by an application.
static var useCodePage:Bool
A Boolean value that determines which code page to use to interpret
* external text files. When the property is set to Text that you load as an external file(using
* false
,
* external text files are interpretted as Unicode.(These files must be
* encoded as Unicode when you save them.) When the property is set to
* true
, external text files are interpretted using the
* traditional code page of the operating system running the application. The
* default value of useCodePage
is false
.
* Loader.load()
, the URLLoader class or URLStream) must have
* been saved as Unicode in order for the application to recognize it as
* Unicode. To encode external files as Unicode, save the files in an
* application that supports Unicode, such as Notepad on Windows.
If you load external text files that are not Unicode-encoded, set
* useCodePage
to true
. Add the following as the
* first line of code of the file that is loading the data(for Flash
* Professional, add it to the first frame):
System.useCodePage = true;
* When this code is present, the application interprets external text * using the traditional code page of the operating system. For example, this * is generally CP1252 for an English Windows operating system and Shift-JIS * for a Japanese operating system.
*If you set useCodePage
to true
, Flash Player
* 6 and later treat text as Flash Player 5 does.(Flash Player 5 treated all
* text as if it were in the traditional code page of the operating system
* running the player.)
If you set useCodePage
to true
, remember that
* the traditional code page of the operating system running the application
* must include the characters used in your external text file in order to
* display your text. For example, if you load an external text file that
* contains Chinese characters, those characters cannot display on a system
* that uses the CP1252 code page because that code page does not include
* Chinese characters.
To ensure that users on all platforms can view external text files used
* in your application, you should encode all external text files as Unicode
* and leave useCodePage
set to false
. This way,
* the application(Flash Player 6 and later, or AIR) interprets the text as
* Unicode.
static function disposeXML(node:XML):Void
Makes the specified XML object immediately available for garbage * collection. This method will remove parent and child connections between * all the nodes for the specified XML node. * *
node | XML reference that should be made available for garbage * collection. |
static function exit(code:UInt):Void
Closes Flash Player.
* For the standalone Flash Player debugger version only.
AIR applications should call the NativeApplication.exit()
* method to exit the application.
code | A value to pass to the operating system. Typically, if the * process exits normally, the value is 0. |
Forces the garbage collection process. * *
For the Flash Player debugger version and AIR applications only.
* In an AIR application, the System.gc()
method is only enabled
* in content running in the AIR Debug Launcher(ADL) or, in an installed
* applcation, in content in the application security sandbox.
Pauses Flash Player or the AIR Debug Launcher(ADL). After calling this * method, nothing in the application continues except the delivery of Socket * events. * *
For the Flash Player debugger version or the AIR Debug Launcher * (ADL) only.
Resumes the application after calling System.pause()
.
*
*
For the Flash Player debugger version or the AIR Debug Launcher * (ADL) only.
static function setClipboard(string:String):Void
Replaces the contents of the Clipboard with a specified text string. This
* method works from any security context when called as a result of a user
* event(such as a keyboard or input device event handler).
* This method is provided for SWF content running in Flash Player 9. It
* allows only adding String content to the Clipboard.
Flash Player 10 content and content in the application security sandbox
* in an AIR application can call the Clipboard.setData()
* method.
string | A plain-text string of characters to put on the system * Clipboard, replacing its current contents(if any). |