Using the System class

Flash Player 9 and later, Adobe AIR 1.0 and later

The System class contains methods and properties that allow you to interact with the user’s operating system and retrieve the current memory usage of the runtime. The methods and properties of the System class also allow you to listen for imeComposition events, instruct the runtime to load external text files using the user’s current code page or to load them as Unicode, or set the contents of the user’s clipboard.

Getting data about the user’s system at run time

By checking the System.totalMemory property, you can determine the amount of memory (in bytes) that the runtime is currently using. This property allows you to monitor memory usage and optimize your applications based on how the memory level changes. For example, if a particular visual effect causes a large increase in memory usage, you may want to consider modifying the effect or eliminating it altogether.

The System.ime property is a reference to the currently installed Input Method Editor (IME). This property allows you to listen for imeComposition events ( flash.events.IMEEvent.IME_COMPOSITION ) by using the addEventListener() method.

The third property in the System class is useCodePage . When useCodePage is set to true , the runtime uses the traditional code page of the operating system to load external text files. If you set this property to false , you tell the runtime to interpret the external file as Unicode.

If you set System.useCodePage to true , remember that the traditional code page of the operating system must include the characters used in your external text file in order for the text to display. For example, if you load an external text file that contains Chinese characters, those characters cannot display on a system that uses the English Windows code page because that code page does not include Chinese characters.

To ensure that users on all platforms can view the external text files that are used in your application, you should encode all external text files as Unicode and leave System.useCodePage set to false by default. This way, the runtime interprets the text as Unicode.

// Ethnio survey code removed