System.useCodepage

Availability

Flash Player 6.

Usage

System.useCodepage

Description

Property; a Boolean value that tells Flash Player whether to use Unicode or the traditional code page of the operating system running the player to interpret external text files. The default value of system.useCodepage is false.

• When the property is set to false, Flash Player interprets external text files as Unicode. (These files must be encoded as Unicode when you save them.)
• When the property is set to true, Flash Player interprets external text files using the traditional code page of the operating system running the player.

Text that you include or load as an external file (using the #include command, the loadVariables() or getURL actions, or the LoadVars or XML objects) must be encoded as Unicode when you save the text file, in order for Flash Player 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 2000.

If you include or load external text files that are not Unicode-encoded, you should set system.useCodepage to true. Add the following code as the first line of code in the first frame of the SWF file that is loading the data:

system.useCodepage = true;

When this code is present, Flash Player interprets external text using the traditional code page of the operating system running Flash Player. This is generally CP1252 for an English Windows operating system and Shift-JIS for a Japanese operating system. If you set system.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 system.useCodepage to true, keep in mind that the traditional code page of the operating system running the player 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 will not 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 SWF files, you should encode all external text files as Unicode and leave System.useCodepage set to false by default. This way Flash Player 6 and later will interpret the text as Unicode.