- fscommand("fullscreen", true<或false>)
该指令设置当前窗口为全屏显示模式或取消全屏。和Flash中原有的fscommand("fullscreen", ..)指令功能相同。当第2个参数为""或省略时,则根据当前窗口模式自动切换是否全屏。
可用性: 第2个参数为""或省略时自动切换全屏需1.1版以上才能支持。
- fscommand("allowscale", true<或false>)
该指令用于允许或禁止动画跟随窗口大小而缩放。和Flash中原有的fscommand("allowscale", ..)指令功能相同。
- fscommand("showmenu", true<或false>)
- fscommand("quit")
该指令用于退出应用程序或关闭窗口。和Flash中原有的fscommand("quit")指令功能相同。
- fscommand("exec", 文件路径)
该指令用于调用或打开外部文件。和Flash中原有的fscommand("exec", ..)指令略有区别,它没有目录的限制(即无需建立fscommand子目录),被调用的“文件路径”可为绝对路径,或以当前exe程序所在目录为基准的相对路径。另外,被调用的文件不仅可以是exe程序,也可以是txt、doc、avi等文档或媒体文件,甚至可以是文件夹。
若所调用的外部文件已作为资源文件打包,则将自动释放该文件到Windows临时目录下再进行调用(不创建子目录,若有重名,则将被覆盖)。
注意:本指令会弹出安全风险提示框。
可用性: 外部文件由资源文件自动释放需1.2版以上才能支持。
- fscommand("close")
该指令和fscommand("quit")指令功能相同。
可用性: 该指令需1.2版以上才能支持。
- fscommand("hide")
隐藏窗口。
可用性: 该指令需1.2版以上才能支持。
- fscommand("show")
显示窗口。
可用性: 该指令需1.2版以上才能支持。
- fscommand("minimize")
该指令将当前程序窗口最小化到任务栏。
- fscommand("maximize")
该指令将当前程序窗口以最大化显示。
可用性: 该指令需1.2版以上才能支持。
- fscommand("restore")
该指令将当前程序窗口恢复为最小化或最大化前的大小。
可用性: 该指令需1.1版以上才能支持。
- fscommand("windowCaption", 窗口标题)
该指令用于设置当前窗口的标题为“窗口标题”参数指定的文字。若“窗口标题”参数为""或省略,则取EXE程序的初始窗口标题。
可用性: 该指令需1.2版以上才能支持。
- fscommand("windowMinSize", 大小)
该指令用于设置当前窗口的最小限制大小。“大小”参数为一个“w,h”格式的字符串,或一个[w,h]格式的数组,其中w、h分别为最小宽度和最小高度。若最小宽度或最小高度希望保持现有值,则可以空字符串来代替(若取值不合法,也将当作空字符串来处理)。
可用性: 该指令需1.3版以上才能支持。
- fscommand("windowMaxSize", 大小)
该指令用于设置当前窗口的最大限制大小。“大小”参数为一个“w,h”格式的字符串,或一个[w,h]格式的数组,其中w、h分别为最大宽度和最大高度。若最大宽度或最大高度希望保持现有值,则可以空字符串来代替(若取值不合法,也将当作空字符串来处理)。若不希望限制最大大小,则可将最大宽度或最大高度的值设为<=0的值。
可用性: 该指令需1.3版以上才能支持。
- fscommand("clientMinSize", 大小)
该指令用于设置当前窗口显示区(窗口边框和标题栏不计算在内)的最小限制大小。“大小”参数为一个“w,h”格式的字符串,或一个[w,h]格式的数组,其中w、h分别为最小宽度和最小高度。若最小宽度或最小高度希望保持现有值,则可以空字符串来代替(若取值不合法,也将当作空字符串来处理)。
可用性: 该指令需1.3版以上才能支持。
- fscommand("clientMaxSize", 大小)
该指令用于设置当前窗口显示区(窗口边框和标题栏不计算在内)的最大限制大小。“大小”参数为一个“w,h”格式的字符串,或一个[w,h]格式的数组,其中w、h分别为最大宽度和最大高度。若最大宽度或最大高度希望保持现有值,则可以空字符串来代替(若取值不合法,也将当作空字符串来处理)。若不希望限制最大大小,则可将最大宽度或最大高度的值设为<=-100的值。
可用性: 该指令需1.3版以上才能支持。
- fscommand("alert", 提示信息)
该指令显示一个Windows提示信息框,包含一个图标、一段由提示“信息参数”指定的文字、以及“确定”和“取消”两个按钮。
- fscommand("dragWindow", true<或false>)
该指令用于拖拽或停止拖拽当前窗口。当执行fscommand("dragWindow", true)后,当前窗口将跟随鼠标移动(不论鼠标按键是否按下),反之执行fscommand("dragWindow",
false)后,窗口将不再跟随鼠标移动。
注意: 在全屏显示状态下,该指令仍然可以设置拖拽状态,但并不产生实际拖拽效果。
- fscommand("dragWindowSize", 拉伸方向)
该指令用于拉伸或停止拉伸当前窗口的大小。“拉伸方向”为包含LTRB四个字符组合的字符串,指明拉伸窗口的哪一侧边或哪一角,例如"LT"表示拉伸左上角,"R"表示拉伸右侧边。若不包含LTRB中的任意一个字符,则表示停止拉伸。执行fscommand("dragWindowSize", ..)后,当前窗口将跟随鼠标移动(不论鼠标按键是否按下)而进行拉伸变形。
注意: 在全屏显示状态下,该指令仍然可以设置拉伸状态,但并不产生实际拉伸效果。
可用性: 该指令需1.3版以上才能支持。
- fscommand("moveWindow", 坐标)
该指令用于移动当前窗口到指定的屏幕坐标。“坐标”参数为一个“x,y”格式的字符串,或一个[x,y]格式的数组,其中x、y分别为X和Y方向上的坐标分量。若某个坐标分量希望保持现有值,则可以空字符串来代替(若取值不合法,也将当作空字符串来处理)。
注意: 全屏显示模式时该指令无效。
可用性: 该指令需1.11版以上标准版才能支持。
- fscommand("showHint", 提示文字)
该指令用于显示或隐藏工具提示。如鼠标移动到按钮上时,可调用fscommand("showHint", "打开文件")来显示一个“打开文件”的工具提示。若“提示文字”参数为""或省略,则当前显示的提示信息将被隐藏。
可用性: 该指令需1.0版以上标准版才能支持。
- fscommand("setCursor", 指针样式)
该指令用于设置当前鼠标指针的样式。“指针样式”参数可为以下几个值:
| "arrow" |
箭头指针。 |
| "cross" |
十字交叉线。 |
| "ibeam" |
文本竖线。 |
| "sizeNESW" |
右上-左下方向箭头。 |
| "sizeNS" |
上下方向箭头。 |
| "sizeNWSE" |
左上-右下方向箭头。 |
| "sizeWE" |
左右方向箭头。 |
| "sizeAll" |
四向箭头。 |
| "upArrow" |
向上箭头。 |
| "glass" |
沙漏。 |
| "drag" |
对象拖动。 |
| "multiDrag" |
多个对象拖动。 |
| "noDrop" |
禁止放下。 |
| "hSplit" |
横向分隔线。 |
| "vSplit" |
纵向分隔线。 |
| "no" |
禁止。 |
| "arrowGlass" |
带沙漏的箭头。 |
| "help" |
带问号的箭头。 |
| "hand" |
手型指向。 |
| 若“指针样式”参数未指定或指定的值不在上述几个值中,则鼠标指针将恢复默认样式。 |
可用性: 该指令需
1.0版以上标准版才能支持。
- fscommand("stayOnTop", true<或false>)
该指令用于动态设置主窗口是否总在最上方显示。
可用性: 该指令需1.1版以上标准版才能支持。
- fscommand("freeDrag", true<或false>)
该指令用于动态设置当前窗口是否可自由拖拽,即不需要手动调用fscommand("dragWindow", ..),而是根据鼠标左键的动作来自动处理(即鼠标在窗口显示区中按下时开始拖拽,放开后停止拖拽)。
可用性: 该指令需1.1版以上标准版才能支持。
- fscommand("rememberPos", true<或false>)
该指令用于动态设置程序是否自动记录程序退出时窗体的位置、大小和状态,以便下次运行时恢复到之前的位置、大小和状态。
可用性: 该指令需1.11版以上标准版才能支持。
- fscommand("sysTray", true<或false>)
该指令用于动态设置是否在系统托盘中显示程序图标。当执行fscommand("sysTray", true)后,系统托盘中将出现应用程序的图标,任务栏按钮在最小化时也将被自动隐藏,反之执行fscommand("sysTray",
false)后,系统托盘中的图标消失,任务栏按钮也恢复原状。
可用性: 该指令需1.1版以上标准版才能支持。
- fscommand("hideTaskBtn", true<或false>)
该指令用于设置是否隐藏任务栏按钮。当执行fscommand("hideTaskBtn", true)后,无论窗口是否最小化,以及是否在系统托盘显示,任务栏中的按钮都将自动隐藏。
可用性: 该指令需1.11版以上标准版才能支持。
- fscommand("screenSnap", true<或false>)
该指令用于设置当前窗口在移动或拉伸时是否可自动吸附到屏幕边缘。
可用性: 该指令需1.3版以上标准版才能支持。
- fscommand("windowAlpha", 不透明度)
该指令用于设置当前窗口的不透明度。其中“不透明度”参数可设置为0~255的整数,取值越小,则窗口越透明,当为0时则窗口完全透明。将“不透明度”参数设为空字符串或省略不写,或取值为负数,则表示不启用窗体透明效果(即前窗口完全不透明)。若“不透明度”参数取值不为空字符串或数值,则不产生任何效果,若取值不在0~255的范围内,则将自动转换到最接近的数值。
注意: 当窗体样式为透明背景时,该指令无效。该指令需要操作系统支持窗体透明属性设置。
可用性: 该指令需1.11版以上标准版才能支持。
- fscommand("resizeWindow", 大小)
该指令用于设置当前窗口的整体大小。“大小”参数为一个“w,h”格式的字符串,或一个[w,h]格式的数组,其中w、h分别为宽度和高度。若宽度或高度希望保持现有值,则可以空字符串来代替(若取值不合法,也将当作空字符串来处理)。
注意: 全屏显示模式时该指令无效。
可用性: 该指令需1.11版以上标准版才能支持。
- fscommand("resizeClient", 大小)
该指令用于设置当前窗口显示区的大小(窗口边框和标题栏不计算在内)。“大小”参数为一个“w,h”格式的字符串,或一个[w,h]格式的数组,其中w、h分别为宽度和高度。若宽度或高度希望保持现有值,则可以空字符串来代替(若取值不合法,也将当作空字符串来处理)。
注意: 全屏显示模式时该指令无效。
可用性: 该指令需1.11版以上标准版才能支持。
- fscommand("allowFileDrop", 文件拖放选项)
该指令用于设置当前窗口是否允许拖放文件,以及支持文件拖放的选项。“文件拖放选项”参数为一个整数,其值由以下各标志值组合相加而得:
| 1 |
可接受文件。 |
| 2 |
可接受文件夹。 |
| 4 |
允许接受多个。 |
| 例如: fscommand("allowFileDrop", 5) 表示当前窗口允许接受多个文件拖放(但文件夹将被忽略)。 |
可用性: 该指令需
1.2版以上标准版才能支持。
- fscommand("basePath", 基准路径)
该指令用于设置当前窗口中的Flash调用外部文件,若采用相对路径时针对的基准路径。
可用性: 该指令需1.2版以上标准版才能支持。
- fscommand("closeModal", 模式返回值)
该指令用于关闭当前模式窗口(仅用于模式子窗口),并指定模式返回值。其中“模式返回值”是一个整数,用于表征窗口关闭的状态(可自定义其含义)。若当前窗口不是模式窗口则该指令无效。
可用性: 该指令需1.2版以上标准版才能支持。
- fscommand("autofree", true<或false>)
该指令用于指定当前窗口(仅用于子窗口)在关闭时是否自动释放。
如果不自动释放,则窗口关闭仅仅表示隐藏,下次打开该窗口时仍将恢复之前的内容,否则,将重新创建该窗口,内容将被重新加载。新建窗口默认为自动释放。
可用性: 该指令需1.2版以上标准版才能支持。
- fscommand("指令名:窗口ID", 指令参数)
该指令用于控制指定窗口(主窗口或子窗口)作为当前窗口执行相应指令。其中“指令名”可用上文中所列的所有fscommand指令。“窗口ID”为指定窗口的ID(参见 ExternalInterface.openWindow 指令,特别的:0表示主窗口,小于0表示最新创建的窗口),若窗口ID不存在,则调用无效。“指令参数”为“指令名”所对应指令的相应参数,具体可参考该指令的帮助。
如 fscommand("fullscreen:-1", true) 表示将最新创建的窗口全屏显示。
可用性: 该指令需1.2版以上标准版才能支持。
- 应用程序信息 = ExternalInterface.call("getAppInfo", 信息标识): String
该指令用于获取当前应用程序的相关信息,获得的信息以字符串形式返回。其中“信息标识”参数可为以下几个值:
| "path" |
获取当前应用程序所在的路径,例如:D:\我的文档\Test\。注意,返回的路径总是以“\”结尾。 |
| "exeFile" |
获取当前应用程序的文件名(不包含路径)。 |
| "mainFile" |
获取主动画文件的原始文件名(不包含路径)。注意,由于打包之后,主动画文件名将被强制更改为内部名称,因此主动画文件的原始文件名和通过ActionScript调用_url获取的文件名是不同的。 |
| "caption" |
获取当前应用程序标题。 |
| "tempPath" |
获取当前用户的临时文件夹路径(为8.3短名格式)。例如:C:\DOCUME~1\aaa\LOCALS~1\Temp\。 |
| 若“信息标识”参数未指定或指定的值不在上述几个值中,则调用无效,返回null(1.12版以下为"null")。 |
可用性: 其中caption需
1.2版以上才能支持,tempPath需
1.3版以上才能支持。
- 窗口位置信息 = ExternalInterface.call("getWindowPos", 位置属性): Number
- 状态信息 = ExternalInterface.call("getState", 状态名称): Boolean
该指令用于获取当前的应用程序或主窗体状态,返回值为true或false(1.12版以下为"true"或"false")。其中“状态名称”参数可为以下几个值:
| "fullscreen" |
判断当前是否为全屏显示,其值会随fscommand("fullscreen", ..)指令的调用而改变。 |
| "showmenu" |
判断当前是否显示Flash右键菜单,其值会随fscommand("showmenu", ..)指令的调用而改变。 |
| "visible" |
判断当前窗口是否显示,其值会随fscommand("show")、fscommand("hide")指令的调用而改变。 |
| "maximize" |
判断当前程序窗口是否最大化,其值会随fscommand("maximize")、fscommand("restore")指令的调用而改变。 |
| "minimize" |
判断当前程序窗口是否最小化,其值会随fscommand("minimize")、fscommand("restore")指令的调用而改变。 |
| "dragging" |
判断当前窗口是否正在拖拽,其值会随fscommand("dragWindow", ..)指令的调用或自由拖拽模式下鼠标的拖拽动作而改变。
注意: 在全屏显示状态下,拖拽状态仍然可以为true,但窗口实际并不产生拖拽效果。 |
| "dragSizing" |
判断当前窗口是否正在拉伸,其值会随fscommand("dragWindowSize", ..)指令的调用而改变。
注意: 在全屏显示状态下,拉伸状态仍然可以为true,但窗口实际并不产生拉伸效果。 |
| "mouseOver" |
判断当前鼠标是否落在当前窗口显示区内,其值会随鼠标的移动而改变。 |
| "stayOnTop" |
判断当前主窗口是否为总在最上方显示,其值会随fscommand("stayOnTop", ..)指令的调用而改变。 |
| "freeDrag" |
判断当前窗口是否可以自由拖拽,其值会随fscommand("freeDrag", .. )指令的调用而改变。 |
| "rememberPos" |
判断当前是否自动记录程序退出时窗体的位置和大小,其值会随fscommand("rememberPos", ..)指令的调用而改变。 |
| "sysTray" |
判断当前是否在系统托盘中显示程序图标,其值会随fscommand("sysTray", ..)指令的调用而改变。 |
| "hideTaskBtn" |
判断当前是否隐藏任务栏按钮,其值会随fscommand("hideTaskBtn", ..)指令的调用而改变。 |
| "trayMenu" |
判断当前是否启用系统托盘菜单,其值会随fscommand("trayMenu", ..)指令的调用而改变。 |
| "screenSnap" |
判断当前窗口是否吸附屏幕边缘,其值会随fscommand("screenSnap", ..)指令的调用而改变。 |
"modalWindow"  |
判断当前窗口是否为模式窗口。 |
"autoFree"  |
判断当前窗口是否可在关闭时自动释放,其值会随fscommand("autoFree", ..)指令的调用而改变。 |
| 若“状态名称”参数未指定或指定的值不在上述几个值中,则调用无效,返回false(1.12版以下为"false")。 |
注意: 由于fscommand指令是异步的,因此调用fscommand("fullscreen", ..)等设置状态的指令后,并不能立刻通过本指令获取最新的状态值,而是需要等Flash执行到下一帧时才能获取。
可用性: 该指令需
1.1版以上才能支持,其中mouseOver、rememberPos、hideTaskBtn、trayMenu四项需
1.11版以上才能支持,visible、maximize需
1.2版以上才能支持,modalWindow、autoFree两项需
1.2版以上标准版才能支持,dragSizing、screenSnap两项需
1.3版以上才能支持。
- 窗口标题 = ExternalInterface.call("getWindowCaption"): String
该指令用于获取当前窗口的标题。
可用性: 该指令需1.2版以上才能支持。
- 主动画文件名 = ExternalInterface.call("getMainFlash"): String
该指令用于获取当前窗口内的主动画文件名(全小写, 含相对路径)。
可用性: 该指令需1.2版以上才能支持。
- 结果状态 = ExternalInterface.call("showMsg", 消息内容, 对话框类型): String
该指令显示一个消息对话框,并根据用户点击的按钮返回对应的结果状态。其中“对话框类型”参数可为以下几个值:
| "info" |
对话框显示为“系统提示”,包含“确定”和“取消”两个按钮,对应的返回状态分别为"ok"和"cancel"。 |
| "error" |
对话框显示为“系统错误”,包含“确定”按钮,对应的返回状态为"ok"。 |
| "confirm" |
对话框显示为“操作确认”,包含“是”、“否”和“取消”三个按钮,对应的返回状态分别为"yes"、"no"和"cancel"。 |
| 若“对话框类型”参数未指定或指定的值不在上述几个值中,则默认使用"info"类型。 |
可用性: 该指令需
1.2版以上普及版或1.0版以上标准版才能支持。
- 文件是否存在 = ExternalInterface.call("fileExists", 文件名): Boolean
该指令用于检测指定的文件是否存在,返回值为true或false。
可用性: 该指令需1.2版以上才能支持。
- 文件夹是否存在 = ExternalInterface.call("folderExists", 文件名): Boolean
该指令用于检测指定的文件夹是否存在,返回值为true或false。
可用性: 该指令需1.2版以上才能支持。
- 文件列表 = ExternalInterface.call("findFiles", 文件名格式, 模式): Array
该指令用于查找符合指定格式文件名的文件或文件夹,返回匹配的文件或文件夹名称列表。其中“文件名格式”中包含要查找的文件夹路径,可使用*和?通配符(例如:C:\Windows\*.dll)。“模式”参数指定查找的是文件、文件夹、还是两者都找,取值分别为"file"、"folder"、"both"。返回的文件名为长名格式,文件夹末尾带有一个反斜杠"\"。
可用性: 该指令需1.2版以上才能支持。
- 是否成功 = ExternalInterface.call("addEventListener", 事件, 事件处理函数名): Boolean
该指令用于添加一个窗口事件处理函数,返回值为true或false(若事件不存在则返回false)。“事件”参数指定具体的窗口事件,可为:
| "close" |
当窗口关闭时触发,并根据事件处理函数的返回结果来判断是否允许关闭窗口。当事件函数返回false或"false"时,表示不允许关闭,否则表示允许关闭。若有多个事件处理函数则按与方式叠加,即当执行到某一事件处理函数时若返回false或"false",则后续事件处理函数将不再执行,并且不允许窗口关闭。 |
| "activate" |
当窗口获得焦点时触发。 |
| "deactivate" |
当窗口失去焦点时触发。 |
| "fullscreen" |
当窗口是否全屏的状态更改时触发。 |
"move"  |
当窗口位置改变时触发。 |
"resize"  |
当窗口大小改变时触发。 |
"dropFiles"  |
当窗口得到拖放进来的文件时触发。 |
“事件处理函数名”指该事件触发时将执行的主动画内部函数。该函数必须是已经用ExternalInterface.addCallback方法注册过的,否则将不会被调用。某些事件(如close)对事件处理函数的返回值有做处理,对于这类事件的处理函数,需要返回true或false来表示执行的结果,以影响事件的后续处理。
可用性: 该指令需
1.2版以上才能支持,其中move、resize、dropFiles三项需
1.2标准版以上才能支持,fullscreen需
1.3版以上才能支持。
- 是否成功 = ExternalInterface.call("removeEventListener", 事件, 事件处理函数名): Boolean
该指令用于清除一个窗口事件处理函数,返回值为true或false(若事件不存在则返回false)。“事件”参数指定具体的窗口事件(具体见ExternalInterface.call("addEventListener", ..)条目)。“事件处理函数名”是已经添加到该事件的响应函数(若为""或省略,则所有该事件的响应函数都将被清除)。
可用性: 该指令需1.2版以上才能支持。
- 函数名列表 = ExternalInterface.call("getEventListeners", 事件): Array
该指令用于获取指定事件的响应函数列表,返回值一个函数名数组(若事件不存在则返回null)。“事件”参数指定具体的窗口事件(具体见ExternalInterface.call("addEventListener", ..)条目)。
可用性: 该指令需1.2版以上才能支持。
- 屏幕信息 = ExternalInterface.call("getScreenInfo", 屏幕属性): Number
该指令用于获取当前屏幕的相关信息,返回值为一个以字符串形式表示的整数。其中“屏幕属性”参数可为以下几个值:
| "width" |
获取屏幕宽度。 |
| "height" |
获取屏幕高度。 |
| "xmouse" |
获取鼠标相对屏幕的X坐标。 |
| "ymouse" |
获取鼠标相对屏幕的Y坐标。 |
| 若“屏幕属性”参数未指定或指定的值不在上述几个值中,则调用无效,返回0(1.12版以下为"0")。 |
可用性: 该指令需
1.11版以上标准版才能支持。
- 窗体样式 = ExternalInterface.call("getWindowType"): Number
该指令用于获取当前窗口的窗体样式,返回值可为"sizable"(可缩放)、"single"(不可缩放)、"dialog(对话框)"、"tool(工具框)"、"sizeTool(可缩放工具框)"、"none"(无边框)、"box"(单线边框)、"transparent"(透明背景)。
可用性: 该指令需1.1版以上标准版才能支持,其中dialog、tool、sizeTool三项需1.2版以上标准版才能支持。
- 窗口不透明度 = ExternalInterface.call("getWindowAlpha"): Number
该指令用于获取当前窗口的不透明度,返回值可为以字符串形式表示的0~255的数值。若窗体透明效果未启用,则返回-1(1.12版以下为"-1")。
可用性: 该指令需1.1版以上标准版才能支持。
- 文件拖放选项 = ExternalInterface.call("getAllowFileDrop"): Number
该指令用于获取当前窗口的文件拖放选项,返回值为文件拖放选项(取值0~7,具体含义见fscommand("allowFileDrop", ..)方法说明)。
可用性: 该指令需1.2版以上标准版才能支持。
- 文件名或列表 = ExternalInterface.call("openDialog", 标题, 文件类型过滤, 默认文件类型, 文件名, 可否多选): String<或Array>
该指令显示一个打开文件对话框,用于选择本地硬盘中的文件,并返回选中的文件名(非多选模式下)或文件名列表(其中文件名均带有完整的路径)。
“标题”参数用于指定对话框的标题文字。
“文件类型过滤”参数用于指定打开文件对话框中可选的文件类型设置,其格式为:类型说明|类型过滤器|类型说明|类型过滤器|...。其中类型过滤器为形如“*.*”的表达式,例如“*.swf”、“*.exe”等,若需要同时表示多个格式,可用“;”进行分隔。
“默认文件类型”参数表示当用户只输入了文件名名称,但未指定后缀名时,自动为其添加的后缀名,比如“swf”。
“文件名”参数表示初始显示的文件名,一般情况下可设为""。
“可否多选”参数表示用户是否可以同时选择多个文件,若该值为真,则返回值为一个数组,每项为一个文件名。
若用户选择取消或直接关闭对话框,则返回值为null(1.12版以下为"")。
可用性: 该指令需1.0版以上标准版才能支持。
- 文件路径 = ExternalInterface.call("saveDialog", 标题, 文件类型过滤, 默认文件类型, 文件名): String
该指令显示一个保存文件对话框,用于选择文件保存的位置,并返回完整的文件保存路径。
“标题”参数用于指定对话框的标题文字。
“文件类型过滤”参数用于指定打开文件对话框中可选的文件类型设置,其格式参见 ExternalInterface.call("openDialog", ..) 指令说明。
“默认文件类型”参数表示当用户只输入了文件名名称,但未指定后缀名时,自动为其添加的后缀名,比如“swf”。
“文件名”参数表示初始显示的文件名,一般情况下可设为""。
若用户选择取消或直接关闭对话框,则返回值为null(1.12版以下为"")。
可用性: 该指令需1.0版以上标准版才能支持。
- 是否成功 = ExternalInterface.call("saveTextFile", 文件名, 内容, 是否ANSI编码): Boolean
该指令用于保存一段文本内容到指定的文件,并返回是否保存成功,即true或false(1.12版以下为"true"或"false")。
“文件名”参数指定需要保存到的文件位置。
“内容”参数指定要保存的文本内容。
“是否ANSI编码”参数指定保存文件的编码格式是否使用ANSI,若为真,则保存的文件为ANSI编码格式,否则保存为UTF-8编码格式(1.12版以下统一保存为UTF-8编码格式)。
注意: 若该文件已经存在,并且并未被设为只读,则该指令将不作任何提示直接覆盖该文件。本指令会弹出安全风险提示框。
可用性: 该指令需1.0版以上标准版才能支持,其中“是否ANSI编码”参数需1.2版以上标准版才能支持。
- 窗口ID = ExternalInterface.call("openWindow", 主动画文件, 强制新窗口, 窗口宽度, 窗口高度, 窗口样式): Number
该指令用于打开一个Flash窗口,并以指定文件为窗口的主动画文件,并返回窗口的ID。
“主动画文件”参数指定该Flash窗口的主动画,可为包内资源文件,亦可为外部文件。
“强制新窗口”参数表示该窗口是否必须为新窗口,若为假,则当已存在一个包含相同主动画的窗口时,将激活该窗口,并返回该窗口的ID,只有不存在时才创建新窗口,若该参数为真,则始终创建新窗口,并返回新窗口的ID。
“窗口宽度”和“窗口高度”参数用于指定新建窗口的大小,若未指定或取值不合法,则采用主窗口初始宽度或高度。
“窗口样式”参数指定窗口的边框样式,可为"sizable"(可缩放)、"single"(不可缩放)、"dialog(对话框)"、"tool(工具框)"、"sizeTool(可缩放工具框)"、"none"(无边框)、"box"(单线边框)、"transparent"(透明背景)。
可用性: 该指令需1.2版以上标准版才能支持。
- 窗口ID列表 = ExternalInterface.call("getWindowList"): Array
该指令用于获取当前打开的所有窗口的ID列表,并以数组格式返回。例如当只打开一个主窗口时,返回[0]。
可用性: 该指令需1.2版以上标准版才能支持。
- 模式返回值 = ExternalInterface.call("showModal"): Number
该指令用于将窗口显示为模式窗口(焦点独占形式的窗口),并获取模式返回值。若当前窗口已为模式窗口,则该指令调用无效,返回0。模式窗口需用fscommand("closeModal", ..)指令来关闭并设置模式返回值,若直接用fscommand("quit"或"close")指令来关闭,则模式返回值为0。
一般该指令以ExternalInterface.call("showModal:窗口ID")的方式调用来显示另一个窗口,并获取其模式返回值。
可用性: 该指令需1.2版以上标准版才能支持。
- 是否成功 = ExternalInterface.call("extractRes", 资源文件名, 保存路径): Boolean
- 返回结果 = ExternalInterface.call("callFunction", 函数名, 相关参数, ...): 任意类型
该指令用于调用窗口主动画的内部函数,并获取函数返回值。
“函数名”指定要被调用的函数的注册名称,该函数必须是已经用ExternalInterface.addCallback方法注册过的,否则将不会被调用。
“相关参数, ...”为调用该函数所需要带的参数,支持任意数据类型(包括对象),参数个数不限。
一般该指令以ExternalInterface.call("callFunction:窗口ID")的方式调用,以实现与另一个窗口的Flash进行通讯。
可用性: 该指令需1.2版以上标准版才能支持。
- 指令返回值 = ExternalInterface.call("指令名:窗口ID", 指令参数, ...): 任意类型
该指令用于控制指定窗口(主窗口或子窗口)作为当前窗口执行相应指令,并返回其执行结果。其中“指令名”可用上文中所列的所有ExternalInterface.call指令。“窗口ID”为指定窗口的ID(参见 ExternalInterface.call("openWindow", ...) 指令说明,特别的:0表示主窗口,小于0表示最新创建的窗口),若窗口ID不存在,则调用无效。“指令参数”等为“指令名”所对应指令的相应参数,具体可参考该指令的帮助。
如 var windowFullscreen: Boolean = ExternalInterface.call("getState:2", "fullscreen") 表示获取窗口ID为2的窗口当前是否全屏。
可用性: 该指令需1.2版以上标准版才能支持。