S > System.useCodepage |  |

System.useCodepage

Availability

Flash Player 6.

Usage

    System.useCodepage

Description

Property; a Boolean value that tells the 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 command is set to `false`, the Flash Player 6 interprets external text files as Unicode. (These files must be encoded as Unicode when you save them.)
| When the command is set to `true`, the Flash Player 6 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 the Flash Player 6 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 movie that is loading the data:

    system.useCodepage = true;

When this code is present, the Flash Player 6 interprets external text using the traditional code page of the operating system running the 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 = true`, the Flash Player 6 treats text like the Flash Player 5. Flash 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 movies, you should encode all external text files as Unicode and leave `System.useCodepage` set to `false` by default. This way the Flash Player 6 will interpret the text as Unicode.