flash.system
public final class System
继承System Inheritance Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

System 类包含与发生在用户计算机上的某些操作相关的属性,如具有共享对象的操作、摄像头和麦克风的本地设置和剪贴板的使用。

其他属性和方法在 flash.system 包的其他类中:Capabilities 类、IME 类和 Security 类。

此类只包含静态方法和属性。无法创建 System 类的新实例。

查看示例

另请参见

flash.system.Security
flash.events.IMEEvent
Using the System class


公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  ime : IME
[静态] [只读 (read-only)] 当前安装的系统 IME。
System
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  totalMemory : uint
[静态] [只读 (read-only)] Adobe® Flash® Player 或 Adobe® AIR™ 当前使用的内存量(以字节为单位)。
System
  useCodePage : Boolean
[静态] 一个布尔值,它决定使用哪个代码页来解释外部文本文件。
System
公共方法
 方法定义方
  
exit(code:uint):void
[静态] 关闭 Flash Player。
System
  
[静态] 强制执行垃圾回收进程。
System
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
  
[静态] 暂停 Flash Player 或 AIR Debug Launcher (ADL)。
System
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
  
[静态] 调用 System.pause() 后,恢复应用程序。
System
  
[静态] 用指定的文本字符串替换剪贴板的内容。
System
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
属性详细信息
ime属性
ime:IME  [只读 (read-only)]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

当前安装的系统 IME。若要为 imeComposition 事件进行注册,请调用此实例上的 addEventListener()



实现
    public static function get ime():IME

另请参见

totalMemory属性 
totalMemory:uint  [只读 (read-only)]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

Adobe® Flash® Player 或 Adobe® AIR™ 当前使用的内存量(以字节为单位)。



实现
    public static function get totalMemory():uint

另请参见

useCodePage属性 
useCodePage:Boolean  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

一个布尔值,它决定使用哪个代码页来解释外部文本文件。当此属性设置为 false 时,会将外部文本文件解释为 Unicode。(保存这些文件时,必须使用 Unicode 对其进行编码。)当此属性设置为 true 时,将使用运行该应用程序的操作系统的传统代码页来解释外部文本文件。useCodePage 的默认值是 false

作为外部文件加载(使用 Loader.load()、URLLoader 类或 URLStream)的文本必须已保存为 Unicode 格式,这样应用程序才能将它识别为 Unicode。若要使用 Unicode 对外部文件进行编码,请在支持 Unicode 的应用程序(例如,Windows 上的“记事本”)中保存这些文件。

如果加载的外部文本文件不是 Unicode 编码格式,则应将 useCodePage 设置为 true。在将加载数据的 文件的中添加以下代码,使之成为第一行代码:

            System.useCodePage = true;
          

如果存在此代码,则应用程序将使用操作系统的传统代码页来解释外部文本。对于英文 Windows 操作系统,该代码页通常为 CP1252;对于日语操作系统,该代码页通常为 Shift-JIS。如果将 useCodePage 设置为 true,则 Flash Player 6 及更高版本处理文本的方式与 Flash Player 5 相同。(Flash Player 5 将所有文本都视为使用运行播放器的操作系统的传统代码页显示文本。)

如果将 useCodePage 设置为 true,则请记住,运行应用程序的操作系统的传统代码页必须包括外部文本文件中使用的字符,这样才能显示文本。例如,如果您加载了一个包含中文字符的外部文本文件,则这些字符不能显示在使用 CP1252 代码页的系统上,因为该代码页不包括中文字符。

为确保所有平台上的用户都能查看您的应用程序中使用的外部文本文件,应将所有外部文本文件按 Unicode 进行编码,并保留 useCodePagefalse 设置。这样,应用程序(Flash Player 6 及更高版本)会将文本解释为 Unicode。



实现
    public static function get useCodePage():Boolean
    public function set useCodePage(value:Boolean):void

另请参见

方法详细信息
exit()方法
public static function exit(code:uint):void

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9.0.115.0

关闭 Flash Player。

仅适用于独立的 Flash Player 调试版。

AIR 应用程序应调用 NativeApplication.exit() 方法来退出应用程序。

参数

code:uint — 传递给操作系统的值。通常,如果进程正常退出,则该值为 0。

另请参见

gc()方法 
public static function gc():void

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9.0.115.0

强制执行垃圾回收进程。

仅限于 Flash Player 调试版和 AIR 应用程序。在 AIR 应用程序中,System.gc() 方法仅限在运行于 AIR Debug Launcher (ADL) 中的内容或已安装的应用程序的应用程序安全沙箱中的内容中启用。

pause()方法 
public static function pause():void

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9.0.115.0

暂停 Flash Player 或 AIR Debug Launcher (ADL)。调用此方法后,除了传送 Socket 事件以外,将停止应用程序中的所有操作。

仅限于 Flash Player 调试版或 AIR Debug Launcher (ADL)。

另请参见

resume()方法 
public static function resume():void

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9.0.115.0

调用 System.pause() 后,恢复应用程序。

仅限于 Flash Player 调试版或 AIR Debug Launcher (ADL)。

另请参见

setClipboard()方法 
public static function setClipboard(string:String):void

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

用指定的文本字符串替换剪贴板的内容。当因用户事件(例如,键盘或鼠标事件处理函数)而调用此方法时,此方法可以在任何安全上下文中使用。

此方法是为 Flash Player 9 中运行的 SWF 内容提供的。它只允许向剪贴板添加 String 内容。在 AIR 应用程序中,Flash Player 10 内容和应用程序安全沙箱中的内容可以调用 Clipboard.setData() 方法。

参数

string:String — 要放置在系统剪贴板上的纯文本字符串,用于替换系统剪贴板上的当前内容(如果有)。

另请参见

示例 如何使用示例
SystemExample.as

下例说明如何通过在对 System.setClipboard() 方法的调用中使用对 System.totalMemory 的调用,将有关系统的总内存的信息复制到系统剪贴板。
package {
    import flash.display.Sprite;
    import flash.system.System;

    public class SystemExample extends Sprite {
        public function SystemExample() {
            System.setClipboard("System.totalMemory: " + System.totalMemory);
        }
    }
}