Flash中fscommand中常用参数

http://hi.baidu.com/aoshifeng/blog/item/42dcb11f565ae609304e15e5.html

 

Flash中fscommand中常用参数

2007年10月22日 星期一 17:38

Flash中fscommand中常用参数

2007-07-16 10:56
用法
fscommand("command", "parameters")
参数
command 一个传递给宿主应用程序用于任何用途的字符串；或者一个传递给 Flash Player 的命令。
parameters 一个传递给宿主应用程序用于任何用途的字符串；或者一个传递给 Flash Player 的值。
返回 无。
说明
函数；使 SWF 文件能够与 Flash Player 或承载 Flash Player 的程序（如 Web 浏览器）进行通讯。还可使用 fscommand 动作将消息传递给 Macromedia Director，或者传递给 Visual Basic、Visual C++ 和其它可承载 ActiveX 控件的程序。
用法 1：若要将消息发送给 Flash Player，必须使用预定义的命令和参数。下表显示可为 fscommand 动作的 command 和 parameters 参数指定的值，这些值用于控制在 Flash player（包括播放器）中播放的 SWF 文件：

【命令】
参数
目的
【quit】
无
关闭播放器。
【fullscreen】
true 或 false
指定 true 将 Flash Player 设置为全屏模式。如果指定 false，播放器会返回到常规菜单视图。
【allowscale】
true 或 false
如果指定 false，则设置播放器以始终按 SWF 文件的原始大小绘制 SWF 文件，从不进行缩放。如果指定 true，则强制 SWF 文件缩放到播放器的 100%。
【showmenu】
true 或 false
如果指定 true，则启用整个上下文菜单项集合。如果指定 false，则使得除“关于 Flash Player”外的所有上下文菜单项变暗。
【exec】
应用程序的路径
在播放器内执行应用程序。
【trapallkeys】
true 或 false
如果指定 true，则将所有按键事件（包括快捷键事件）发送到 Flash Player 中的 onClipEvent(keyDown/keyUp) 处理函数。
exec 命令只能包含字符 A 至 Z、a 至 z、0 至 9、句点 (). 和下划线 (_)。exec 仅在子目录 fscommand 中运行。也就是说，如果您使用 fscommand exec 命令调用应用程序，该应用程序必须位于名为 fscommand 的子目录中。

用法 2：若要在 Web 浏览器中使用 fscommand 动作将消息发送到脚本撰写语言（如 JavaScript），可以在 command 和 parameters 参数中传递任意两个参数。这些参数可以是字符串或表达式，它们在“捕获”或处理 fscommand 动作的 JavaScript 函数中使用。

在 Web 浏览器中，fscommand 动作在包含 SWF 文件的 HTML 页中调用 JavaScript 函数 moviename_DoFScommand。moviename 是 Flash Player 影片的名称，该名称由 EMBED 标签的 NAME 属性指定，或者由 OBJECT 标签的 ID 属性指定。如果您为 Flash Player 影片指定名称 myDocument，所调用的 JavaScript 函数就是 myDocument_DoFScommand。

用法 3：fscommand 动作可以将消息发送给 Macromedia Director，Lingo 将消息解释为字符串、事件或可执行的 Lingo 代码。如果该消息为字符串或事件，则必须编写 Lingo 代码以便从 fscommand 动作接收该消息，并在 Director 中执行动作。有关更多信息，请参见 Director 支持中心，网址为 www.macromedia.com/support/director。

用法 4：在 Visual Basic、Visual C++ 和可承载 ActiveX 控件的其它程序中，fscommand 利用可在环境的编程语言中处理的两个字符串发送 VB 事件。有关更多信息，请使用 Flash method（Flash 方法）关键字搜索 Flash 支持中心，网址为 www.macromedia.com/go/flash_support_cn。

示例
用法 1：在下面的示例中，fscommand 动作设置 Flash Player，以便在释放按钮时，将 SWF 文件放大到整个显示器屏幕大小。

on (release) {
fscommand("fullscreen", true);
}

用法 2：下面的示例使用应用到 Flash 中按钮的 fscommand 动作打开 HTML 页中的 JavaScript 消息框。消息本身作为 fscommand 参数发送到 JavaScript。

必须将一个函数添加到包含 SWF 文件的 HTML 页。此函数 (myDocument_DoFSCommand) 位于 HTML 页中，等待 Flash 中的 fscommand 动作。当在 Flash 中触发 fscommand 后（例如，当用户按下按钮时），command 和 parameter 字符串被传递到 myDocument_DoFSCommand 函数。可以在 JavaScript 或 VBScript 代码中以任何需要的方式使用所传递的字符串。在此示例中，该函数包含一个条件 if 语句，该语句检查命令字符串是否为 "messagebox"。如果是，则 JavaScript 警告框（或“消息框”）打开并显示 parameters 字符串的内容。

function myDocument_DoFSCommand(command, args) {
if (command == "messagebox") {
alert(args);
}
}

在 Flash 文档中，将 fscommand 动作添加到按钮：

fscommand("messagebox", "This is a message box called from within Flash.")

也可以为 fscommand 动作和参数使用表达式，如下面的示例所示：

fscommand("messagebox", "Hello, " + name + ", welcome to our website!")

若要测试影片，请选择“文件”>“发布预览”>“HTML”。

注意：如果在 HTML“发布设置”中使用具有 FSCommand 模板的 Flash 发布 SWF 文件，则将自动插入 myDocument_DoFSCommand 函数。该 SWF 文件的 NAME 和 ID 属性将是文件名。例如，对于文件 myDocument.fla，这些属性将设置为 myDocument。