Package | flash.system |
Class | public final class System |
Inheritance | System Object |
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
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.
See also
Property | Defined By | ||
---|---|---|---|
constructor : Object
A reference to the class object or constructor function for a given object instance. | Object | ||
ime : IME [static] [read-only]
The currently installed system IME. | System | ||
prototype : Object [static]
A reference to the prototype object of a class or function object. | Object | ||
totalMemory : uint [static] [read-only]
The amount of memory (in bytes) currently in use by Adobe®
Flash® Player or Adobe® AIR®. | System | ||
useCodePage : Boolean [static]
A Boolean value that determines which code page to use to interpret external text files. | System |
Method | Defined By | ||
---|---|---|---|
[static]
Makes the specified XML object immediately available for garbage collection. | System | ||
[static]
Closes Flash Player. | System | ||
[static]
Forces the garbage collection process. | System | ||
Indicates whether an object has a specified property defined. | Object | ||
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | ||
[static]
Pauses Flash Player or the AIR Debug Launcher (ADL). | System | ||
Indicates whether the specified property exists and is enumerable. | Object | ||
[static]
Resumes the application after calling System.pause(). | System | ||
[static]
Replaces the contents of the Clipboard with a specified text string. | System | ||
Sets the availability of a dynamic property for loop operations. | Object | ||
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | ||
Returns the string representation of the specified object. | Object | ||
Returns the primitive value of the specified object. | Object |
ime | property |
ime:IME
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The currently installed system IME.
To register for imeComposition events, call
addEventListener()
on this instance.
Implementation
public static function get ime():IME
See also
totalMemory | property |
totalMemory:uint
[read-only] Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
The amount of memory (in bytes) currently in use by Adobe® Flash® Player or Adobe® AIR®.
Implementation
public static function get totalMemory():uint
useCodePage | property |
useCodePage:Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
A Boolean value that determines which code page to use to interpret external text files.
When the property is set to 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
.
Text that you load as an external file (using 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 in the first frame of the file that
is loading the data:
System.useCodePage = true;
When this code is present, the application interprets external text
using the traditional code page of the operating system.
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) interprets the text as Unicode.
Implementation
public static function get useCodePage():Boolean
public static function set useCodePage(value:Boolean):void
See also
disposeXML | () | method |
public static function disposeXML(node:XML):void
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.5.2 |
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.
Parameters
node:XML — XML reference that should be made available for garbage collection.
|
exit | () | method |
public static function exit(code:uint):void
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9.0.115.0 |
Closes Flash Player.
For the standalone Flash Player debugger version only.
AIR applications should call the NativeApplication.exit()
method to exit the application.
Parameters
code:uint — A value to pass to the operating system. Typically, if
the process exits normally, the value is 0.
|
See also
gc | () | method |
public static function gc():void
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9.0.115.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.
pause | () | method |
public static function pause():void
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9.0.115.0 |
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.
See also
resume | () | method |
public static function resume():void
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9.0.115.0 |
Resumes the application after calling System.pause()
.
For the Flash Player debugger version or the AIR Debug Launcher (ADL) only.
See also
setClipboard | () | method |
public static function setClipboard(string:String):void
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0 Flash Player 9 |
Replaces the contents of the Clipboard with a specified text string. This method works from any security context when called as a result of user event (such as a keyboard or mouse 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.
Parameters
string:String — A plain-text string of characters to put on the system Clipboard, replacing its current contents (if any).
|
See also
System.totalMemory
within a call to the
System.setClipboard()
method.
package { import flash.display.Sprite; import flash.system.System; public class SystemExample extends Sprite { public function SystemExample() { System.setClipboard("System.totalMemory: " + System.totalMemory); } } }
Fri Mar 19 2010, 02:45 AM -07:00