window.runtime 属性window.runtime.flash.system.System
继承System Inheritance Object

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

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

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

查看示例

另请参见

Security

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
hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
  
[静态] 暂停 Flash Player 或 AIR Debug Launcher (ADL)。
System
 Inherited
propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。
Object
  
[静态] 调用 System.pause() 后,恢复应用程序。
System
  
setClipboard(string:String):void
[静态] 用指定的文本字符串替换剪贴板的内容。
System
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。
Object
 Inherited
toString():String
返回指定对象的字符串表示形式。
Object
 Inherited
valueOf():Object
返回指定对象的原始值。
Object
属性详细信息
ime属性
ime:IME  [只读 (read-only)]

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

另请参见

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

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

另请参见

useCodePage属性 
useCodePage:Boolean  [读写]

一个布尔值,它决定使用哪个代码页来解释外部文本文件。当此属性设置为 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。

另请参见

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

关闭 Flash Player。

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

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

参数

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

另请参见

gc()方法 
function gc():void

强制执行垃圾回收进程。

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

pause()方法 
function pause():void

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

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

另请参见

resume()方法 
function resume():void

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

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

另请参见

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

用指定的文本字符串替换剪贴板的内容。

注意:出于安全方面的考虑,Flash Player 内容无法读取系统剪贴板的内容。换句话说,不存在相应的 System.getClipboard() 方法。不过,AIR 应用程序的应用程序安全沙箱中的内容可以通过 Clipboard.getData() 方法访问剪贴板的内容。

此方法是为 Flash Player 中运行的 SWF 内容提供的。AIR 应用程序的应用程序安全沙箱中的内容应该调用 Clipboard.setData() 方法。

参数

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

另请参见

示例
SystemExample.as

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

注意:要测试此示例,请执行以下操作:

  1. 将 AIRAliases.js 文件添加到项目目录。
  2. 为该项目创建应用程序描述符文件,并使用 ADL 测试该项目。
<html>
    <head>
      <script src="AIRAliases.js" />
      <script>
        function init() {
            air.System.setClipboard("air.System.totalMemory: " + air.System.totalMemory);
        }
      </script>
    </head>
    <body onload='init()'>
    </body>
</html>