System.useCodepage

Disponibilidad

Flash Player 6.

Sintaxis

System.useCodepage 

Descripción

Propiedad; valor booleano que indica a Flash Player si debe utilizar Unicode o la página de códigos tradicional del sistema operativo en el que se ejecuta el reproductor para interpretar los archivos de texto externos. El valor predeterminado de system.useCodepage es false.

• Cuando la propiedad se establece en false, Flash Player interpreta los archivos de texto externos como Unicode. Estos archivos deben codificarse como Unicode al guardarlos.
• Cuando la propiedad se establece en true, Flash Player interpreta los archivos de texto externos utilizando la página de códigos tradicional del sistema operativo en el que se ejecuta el reproductor.

El texto que se incluye o se carga como archivo externo (mediante el comando #include, las acciones loadVariables() o getURL o los objetos LoadVars o XML) debe codificarse como Unicode al guardar el archivo de texto para que Flash Player pueda reconocerlo como Unicode. Para codificar archivos externos como Unicode, guarde los archivos en una aplicación que admita Unicode, como el Bloc de notas de Windows 2000.

Si incluye o carga archivos de texto externos cuya codificación no es Unicode, debe establecer system.useCodepage en true. Añada el código siguiente como primera línea del código del primer fotograma del archivo SWF que carga los datos:

system.useCodepage = true;

Cuando este código está presente, Flash Player interpreta el texto externo mediante la página de códigos tradicional del sistema operativo en el que se ejecuta Flash Player. Generalmente es CP1252 para un sistema operativo Windows en inglés y Shift-JIS para un sistema operativo en japonés. Si establece system.useCodepage en true, Flash Player 6 y las versiones posteriores tratan el texto del mismo modo que Flash Player 5. Flash Player 5 trataba todo el texto como si estuviese en la página de códigos tradicional del sistema operativo en el que se ejecutaba el reproductor.

Si establece system.useCodepage en true, debe tener en cuenta que la página de códigos tradicional del sistema operativo en el que se ejecuta el reproductor debe incluir los caracteres que se utilizan en el archivo de texto externo para que el texto pueda visualizarse. Por ejemplo, si carga un archivo de texto externo que contiene caracteres chinos, dichos caracteres no se visualizarán en un sistema que utilice la página de códigos CP1252, ya que dicha página de códigos no contiene caracteres chinos.

Para asegurarse de que los usuarios de todas las plataformas pueden ver los archivos de texto externos que se utilizan en sus archivos SWF, debe codificar todos los archivos de texto externos como Unicode y dejar la propiedad System.useCodepage establecida en false de forma predeterminada. De este modo, Flash Player 6 y las versiones posteriores interpretarán el texto como Unicode.