fscommand 函数

fscommand 函数

fscommand() 函数使 SWF 文件与 Web 页中的脚本能进行通讯。不过，脚本访问是由 Web 页的 allowScriptAccess 设置控制的。

用法 1：若要使用 fscommand() 将消息发送给 Flash Player，必须使用预定义的命令和参数。下表列出了可以为 fscommand() 函数的 command 参数和 parameters 参数指定的值。这些值控制在 Flash Player 中播放的 SWF 文件，包括放映文件。（放映文件 是以可作为独立应用程序运行（也就是说，不需要使用 Flash Player 即可运行）的格式保存的 SWF 文件。）

命令	参数	目的
quit	无	关闭放映文件。
fullscreen	true 或者 false	指定 true 可将 Flash Player 设置为全屏模式。指定 false 可将播放器返回到标准菜单视图。 true(允许全屏)或者false(禁止全屏)，系统默认值为false。
allowscale	true 或者 false	指定 false 可设置播放器始终按 SWF 文件的原始大小绘制 SWF 文件，从不进行缩放。指定 true 会强制将 SWF 文件缩放到播放器的 100% 大小。 true(允许缩放)或者false(禁止缩放)，系统默认值为true
showmenu	true 或者 false	指定 true 可启用整个上下文菜单项集合。指定 false 将隐藏除"关于 Flash Player"和"设置"外的所有上下文菜单项。 true(允许显示)或者false(禁止显示)，系统默认值为true。
exec	应用程序的路径	在放映文件内执行应用程序。
trapallkeys	true 或者 false	指定 true 可将所有按键事件（包括快捷键）发送到 Flash Player 中的 onClipEvent(keyDown/keyUp) 处理函数。

可用性：

• 表中描述的命令在 Web 播放器中都不可用。
• 所有这些命令在独立的应用程序（例如，放映文件）中都可用。
• 只有 allowscale 和 exec 在测试影片播放器中可用。

参数

command:String - 传递给主机应用程序用于任何用途的一个字符串，或传递给 Flash Player 的一个命令。

parameters:String - 传递给主机应用程序用于任何用途的一个字符串，或传递给 Flash Player 的一个值。

示例

在下面的示例中，fscommand() 将 Flash Player 设置为在松开 fullscreen_btn 或 unfullscreen_btn 按钮时将 SWF 文件放大到整个显示器屏幕大小。

this.fullscreen_btn.onRelease = function() {
 fscommand("fullscreen", true);
};

this.unfullscreen_btn.onRelease = function() {
 fscommand("fullscreen", false);
};