《Flash Lite 2.x ActionScript 语言参考》

全局函数

本节包含了一组内置函数，凡是使用 ActionScript 的 SWF 文件的任何部分都可使用这些函数。这些全局函数涵盖了各种各样的常见编程任务，如处理数据类型（Boolean()、int() 等）、生成调试信息 (trace()) 以及与 Flash Player 或浏览器进行通讯 (fscommand())。

全局函数摘要

修饰符

签名

说明

Array([numElements], [elementN]) : Array

创建一个新的空数组，或者将指定的元素转换为数组。

Boolean(expression:Object) : Boolean

将参数 expression 转换为布尔值并返回 true 或 false。

call(frame:Object)

自 Flash Player 5 后不推荐使用。不推荐使用此动作，而推荐使用 function 语句。

执行被调用的帧中的脚本，而不将播放头移动到该帧。

chr(number:Number) : String

自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 String.fromCharCode()。

将 ASCII 代码数字转换为字符。

clearInterval(intervalID:Number)

取消由 setInterval() 调用创建的间隔。

duplicateMovieClip(target:Object, newname:String, depth:Number)

当 SWF 文件正在播放时，创建一个影片剪辑的实例。

escape(expression:String) : String

将参数转换为字符串，并以 URL 编码格式对其进行编码，在这种格式中，所有非字母数字的字符都替换为 % 十六进制序列。

eval(expression:Object) : Object

按名称访问变量、属性、对象或影片剪辑。

fscommand(command:String, parameters:String)

使 SWF 文件能够与 Flash Lite 播放器或移动设备的环境（如操作系统）进行通信。

fscommand2(command:String, parameters:String)

使 SWF 文件能够与 Flash Lite 播放器或移动设备上的主机应用程序进行通信。

getProperty(my_mc:Object, property:Object) : Object

自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 Flash Player 5 中引入的点语法。

返回影片剪辑 my_mc 的指定属性的值。

getTimer() : Number

返回自 SWF 文件开始播放时起已经过的毫秒数。

getURL(url:String, [window:String], [method:String])

将来自特定 URL 的文档加载到窗口中，或将变量传递到位于所定义 URL 的另一个应用程序。

getVersion() : String

返回一个包含 Flash Player 版本和平台信息的字符串。

gotoAndPlay([scene:String], frame:Object)

将播放头转到场景中指定的帧并从该帧开始播放。

gotoAndStop([scene:String], frame:Object)

将播放头转到场景中指定的帧并停止播放。

ifFrameLoaded([scene:String], frame:Object, statement(s):Object)

自 Flash Player 5 后不推荐使用。此函数已不推荐使用。Adobe 建议您使用 MovieClip._framesloaded 属性。

检查特定帧的内容是否可在本地使用。

int(value:Number) : Number

自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 Math.round()。

通过截断小数值将小数转换为整数值。

isFinite(expression:Object) : Boolean

计算 expression，如果结果为有限数，则返回 true；如果为无穷大或负无穷大，则返回 false。

isNaN(expression:Object) : Boolean

计算参数，如果值为 NaN（非数字），则返回 true。

length(expression:String, variable:Object) : Number

自 Flash Player 5 后不推荐使用。此函数及所有字符串函数已不推荐使用。Adobe 建议您使用 String 类的方法和 String.length 属性来执行相同的操作。

返回指定字符串或变量的长度。

loadMovie(url:String, target:Object, [method:String])

在播放原始 SWF 文件的同时将 SWF 文件或 JPEG 文件加载到 Flash Player 中。

loadMovieNum(url:String, level:Number, [method:String])

在播放原来加载的 SWF 文件的同时将 SWF 文件或 JPEG 文件加载到 Flash Player 的某个级别中。

loadVariables(url:String, target:Object, [method:String])

从外部文件（例如文本文件，或由 ColdFusion、CGI 脚本、Active Server Page (ASP)、PHP 或 Perl 脚本生成的文本）中读取数据，并设置目标影片剪辑中变量的值。

loadVariablesNum(url:String, level:Number, [method:String])

从外部文件（如文本文件，或由 ColdFusion、CGI 脚本、ASP、PHP 或 Perl 脚本生成的文本）中读取数据，并设置 Flash Player 的某个级别中的变量的值。

mbchr(number:Number)

自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 String.fromCharCode() 方法。

将 ASCII 码数字转换为多字节字符。

mblength(string:String) : Number

自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 String.length 属性。

返回多字节字符串的长度。

mbord(character:String) : Number

自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 String.charCodeAt() 方法。

将指定字符转换为多字节数字。

mbsubstring(value:String, index:Number, count:Number) : String

自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 String.substr() 方法。

从多字节字符串中提取一个新的多字节字符串。

nextFrame()

将播放头转到下一帧。

nextScene()

将播放头转到下一场景的第 1 帧。

Number(expression:Object) : Number

将参数 expression 转换为数字。

Object([value:Object]) : Object

创建一个新的空对象，或者将指定的数字、字符串或布尔值转换为一个对象。

on(mouseEvent:Object)

指定触发动作的鼠标事件或按键。

onClipEvent(movieEvent:Object)

触发为特定影片剪辑实例定义的动作。

ord(character:String) : Number

自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 String 类的方法和属性。

将字符转换为 ASCII 码数字。

parseFloat(string:String) : Number

将字符串转换为浮点数。

parseInt(expression:String, [radix:Number]) : Number

将字符串转换为整数。

play()

在时间轴中向前移动播放头。

prevFrame()

将播放头转到前一帧。

prevScene()

将播放头转到前一场景的第 1 帧。

random(value:Number) : Number

自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 Math.random()。

返回一个随机整数，此整数介于 0 和小于在 value 参数中指定的整数之间。

removeMovieClip(target:Object)

删除指定的影片剪辑。

setInterval(functionName:Object, interval:Number, [param:Object], objectName:Object, methodName:String) : Number

在播放 SWF 文件时，每隔一定时间就调用函数或对象的方法。

setProperty(target:Object, property:Object, expression:Object)

当影片剪辑播放时，更改影片剪辑的属性值。

startDrag(target:Object, [lock:Boolean], [left,top,right,bottom:Number])

使 target 影片剪辑在影片播放过程中可拖动。

stop()

停止当前正在播放的 SWF 文件。

stopAllSounds()

在不停止播放头的情况下停止 SWF 文件中当前正在播放的所有声音。

stopDrag()

停止当前的拖动操作。

String(expression:Object) : String

返回指定参数的字符串表示形式。

substring(string:String, index:Number, count:Number) : String

自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 String.substr()。

提取部分字符串。

targetPath(targetObject:Object) : String

返回包含 movieClipObject 的目标路径的字符串。

tellTarget(target:String, statement(s):Object)

自 Flash Player 5 后不推荐使用。Adobe 建议使用点 (.)记号和 with 语句。

将在 statements 参数中指定的指令应用于在 target 参数中指定的时间轴。

toggleHighQuality()

自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 _quality。

在 Flash Player 中启用和禁用消除锯齿功能。

trace(expression:Object)

计算表达式并输出结果。

unescape(string:String) : String

将参数 x 作为字符串计算，将该字符串从 URL 编码格式解码（将所有十六进制序列转换为 ASCII 字符），并返回该字符串。

unloadMovie(target)

从 Flash Player 中删除通过 loadMovie() 加载的影片剪辑。

unloadMovieNum(level:Number)

从 Flash Player 中删除通过 loadMovieNum() 加载的 SWF 或图像。

修饰符	签名	说明
	Array`([numElements], [elementN]) : Array`	创建一个新的空数组，或者将指定的元素转换为数组。
	Boolean`(expression:Object) : Boolean`	将参数 expression 转换为布尔值并返回 `true` 或 `false`。
	call`(frame:Object)`	自 Flash Player 5 后不推荐使用。不推荐使用此动作，而推荐使用 `function` 语句。执行被调用的帧中的脚本，而不将播放头移动到该帧。
	chr`(number:Number) : String`	自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 `String.fromCharCode()`。将 ASCII 代码数字转换为字符。
	clearInterval`(intervalID:Number)`	取消由 `setInterval()` 调用创建的间隔。
	duplicateMovieClip`(target:Object, newname:String, depth:Number)`	当 SWF 文件正在播放时，创建一个影片剪辑的实例。
	escape`(expression:String) : String`	将参数转换为字符串，并以 URL 编码格式对其进行编码，在这种格式中，所有非字母数字的字符都替换为 % 十六进制序列。
	eval`(expression:Object) : Object`	按名称访问变量、属性、对象或影片剪辑。
	fscommand`(command:String, parameters:String)`	使 SWF 文件能够与 Flash Lite 播放器或移动设备的环境（如操作系统）进行通信。
	fscommand2`(command:String, parameters:String)`	使 SWF 文件能够与 Flash Lite 播放器或移动设备上的主机应用程序进行通信。
	getProperty`(my_mc:Object, property:Object) : Object`	自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 Flash Player 5 中引入的点语法。返回影片剪辑 my_mc 的指定属性的值。
	getTimer`() : Number`	返回自 SWF 文件开始播放时起已经过的毫秒数。
	getURL`(url:String, [window:String], [method:String])`	将来自特定 URL 的文档加载到窗口中，或将变量传递到位于所定义 URL 的另一个应用程序。
	getVersion`() : String`	返回一个包含 Flash Player 版本和平台信息的字符串。
	gotoAndPlay`([scene:String], frame:Object)`	将播放头转到场景中指定的帧并从该帧开始播放。
	gotoAndStop`([scene:String], frame:Object)`	将播放头转到场景中指定的帧并停止播放。
	ifFrameLoaded`([scene:String], frame:Object, statement(s):Object)`	自 Flash Player 5 后不推荐使用。此函数已不推荐使用。Adobe 建议您使用 `MovieClip._framesloaded` 属性。检查特定帧的内容是否可在本地使用。
	int`(value:Number) : Number`	自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 `Math.round()`。通过截断小数值将小数转换为整数值。
	isFinite`(expression:Object) : Boolean`	计算 expression，如果结果为有限数，则返回 `true`；如果为无穷大或负无穷大，则返回 `false`。
	isNaN`(expression:Object) : Boolean`	计算参数，如果值为 `NaN`（非数字），则返回 `true`。
	length`(expression:String, variable:Object) : Number`	自 Flash Player 5 后不推荐使用。此函数及所有字符串函数已不推荐使用。Adobe 建议您使用 String 类的方法和 `String.length` 属性来执行相同的操作。返回指定字符串或变量的长度。
	loadMovie`(url:String, target:Object, [method:String])`	在播放原始 SWF 文件的同时将 SWF 文件或 JPEG 文件加载到 Flash Player 中。
	loadMovieNum`(url:String, level:Number, [method:String])`	在播放原来加载的 SWF 文件的同时将 SWF 文件或 JPEG 文件加载到 Flash Player 的某个级别中。
	loadVariables`(url:String, target:Object, [method:String])`	从外部文件（例如文本文件，或由 ColdFusion、CGI 脚本、Active Server Page (ASP)、PHP 或 Perl 脚本生成的文本）中读取数据，并设置目标影片剪辑中变量的值。
	loadVariablesNum`(url:String, level:Number, [method:String])`	从外部文件（如文本文件，或由 ColdFusion、CGI 脚本、ASP、PHP 或 Perl 脚本生成的文本）中读取数据，并设置 Flash Player 的某个级别中的变量的值。
	mbchr`(number:Number)`	自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 `String.fromCharCode()` 方法。将 ASCII 码数字转换为多字节字符。
	mblength`(string:String) : Number`	自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 `String.length` 属性。返回多字节字符串的长度。
	mbord`(character:String) : Number`	自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 `String.charCodeAt()` 方法。将指定字符转换为多字节数字。
	mbsubstring`(value:String, index:Number, count:Number) : String`	自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 `String.substr()` 方法。从多字节字符串中提取一个新的多字节字符串。
	nextFrame`()`	将播放头转到下一帧。
	nextScene`()`	将播放头转到下一场景的第 1 帧。
	Number`(expression:Object) : Number`	将参数 expression 转换为数字。
	Object`([value:Object]) : Object`	创建一个新的空对象，或者将指定的数字、字符串或布尔值转换为一个对象。
	on`(mouseEvent:Object)`	指定触发动作的鼠标事件或按键。
	onClipEvent`(movieEvent:Object)`	触发为特定影片剪辑实例定义的动作。
	ord`(character:String) : Number`	自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 String 类的方法和属性。将字符转换为 ASCII 码数字。
	parseFloat`(string:String) : Number`	将字符串转换为浮点数。
	parseInt`(expression:String, [radix:Number]) : Number`	将字符串转换为整数。
	play`()`	在时间轴中向前移动播放头。
	prevFrame`()`	将播放头转到前一帧。
	prevScene`()`	将播放头转到前一场景的第 1 帧。
	random`(value:Number) : Number`	自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 `Math.random()`。返回一个随机整数，此整数介于 0 和小于在 value 参数中指定的整数之间。
	removeMovieClip`(target:Object)`	删除指定的影片剪辑。
	setInterval`(functionName:Object, interval:Number, [param:Object], objectName:Object, methodName:String) : Number`	在播放 SWF 文件时，每隔一定时间就调用函数或对象的方法。
	setProperty`(target:Object, property:Object, expression:Object)`	当影片剪辑播放时，更改影片剪辑的属性值。
	startDrag`(target:Object, [lock:Boolean], [left,top,right,bottom:Number])`	使 target 影片剪辑在影片播放过程中可拖动。
	stop`()`	停止当前正在播放的 SWF 文件。
	stopAllSounds`()`	在不停止播放头的情况下停止 SWF 文件中当前正在播放的所有声音。
	stopDrag`()`	停止当前的拖动操作。
	String`(expression:Object) : String`	返回指定参数的字符串表示形式。
	substring`(string:String, index:Number, count:Number) : String`	自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 `String.substr()`。提取部分字符串。
	targetPath`(targetObject:Object) : String`	返回包含 movieClipObject 的目标路径的字符串。
	tellTarget`(target:String, statement(s):Object)`	自 Flash Player 5 后不推荐使用。Adobe 建议使用点 (.)记号和 `with` 语句。将在 statements 参数中指定的指令应用于在 target 参数中指定的时间轴。
	toggleHighQuality`()`	自 Flash Player 5 后不推荐使用。不推荐使用此函数，而推荐使用 `_quality`。在 Flash Player 中启用和禁用消除锯齿功能。
	trace`(expression:Object)`	计算表达式并输出结果。
	unescape`(string:String) : String`	将参数 x 作为字符串计算，将该字符串从 URL 编码格式解码（将所有十六进制序列转换为 ASCII 字符），并返回该字符串。
	unloadMovie`(target)`	从 Flash Player 中删除通过 `loadMovie()` 加载的影片剪辑。
	unloadMovieNum`(level:Number)`	从 Flash Player 中删除通过 `loadMovieNum()` 加载的 SWF 或图像。

查看 LiveDocs 上的注释