System.usecodepage - MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Reference

System.useCodepage

Availability
Flash Player 6.
Usage
System.useCodepage:Boolean
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
•
When the property is set to
files must be encoded as Unicode when you save them.)
•
When the property is set to
code page of the operating system running the player.
Text that you load as an external file (using the
LoadVars class or
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 load external text files that are not Unicode-encoded, you should set
to . Add the following code as the first line of code in the first frame of the SWF file that is
true
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
to , Flash Player 6 and later treat text as Flash Player 5 does. (Flash Player 5 treated all text as
true
if it were in the traditional code page of the operating system running the player.)
If you set
System.useCodepage
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 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 SWF files, you
should encode all external text files as Unicode and leave
default. This way, Flash Player 6 and later interprets the text as Unicode.
856 Chapter 2: ActionScript Language Reference
is .
false
, Flash Player interprets external text files as Unicode. (These
false
, Flash Player interprets external text files using the traditional
true
XML class) must be encoded as Unicode when you save the text file in order for
to
true
loadVariables()
, remember that the traditional code page of the
System.useCodepage
or getURL() statements, or the
System.useCodepage
System.useCodepage
set to by
false