User Guide

433
16
CHAPTER 16
Client System Environment
The client system environment is a collection of classes in the flash.system package that allow
you to access system-level functionality such as determining which application and security
domain a SWF is executing in, determining the capabilities of the user’s Flash Player, building
multilingual sites using the Input Method Editor (IME), interacting with the Flash Player’s
container (which could be an HTML page or a container application), or saving information
to the user’s Clipboard. The flash.system package also includes the IMEConversionMode and
SecurityPanel classes. These classes contain static constants that you use with the IME and
Security classes, respectively.
This chapter explains how to interact with the user’s system. It shows you how to determine
what features are supported and how to build multilingual SWF files using the user’s installed
IME (if available). It also shows typical uses for application domains.
Contents
System class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .433
Capabilities class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .435
ApplicationDomain class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .436
IME class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
Example: Detecting system capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
System class
The System class contains methods and properties that allow you to interact with the user’s
operating system and retrieve the current memory usage for Flash Player. The methods and
properties of the System class also allow you to listen for
imeComposition events, instruct
Flash Player 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.