fscommand

 

fscommand

fscommand

可用性

Flash Player 3。

用法

fscommand("command", "parameters")

参数

command 一个传递给宿主应用程序用于任何用途的字符串；或者一个传递给独立 Flash Player 的命令。

parameters 一个传递给宿主应用程序用于任何用途的字符串；或者一个传递给 Flash Player 的值。

返回

无。

说明

动作；使 Flash 影片能够与 Flash Player 或承载 Flash Player 的程序（如 Web 浏览器）进行通讯。还可使用 fscommand 动作将消息传递给 Macromedia Director，或者传递给 Visual Basic、Visual C++ 和其他可承载 ActiveX 控件的程序。

用法 1：若要将消息发送给 Flash Player，必须使用预定义的命令和参数。下表显示可为 fscommand 动作的 command 和 parameters 参数指定的值，这些值用于控制在独立 Flash player（包括播放器）中播放的影片：

命令	参数	目的
quit	无	关闭播放器。
fullscreen	true 或 false	指定 true，则将 Flash Player 设置为全屏模式。指定 false，则将播放器返回到普通菜单视图。
allowscale	true 或 false	指定 false，则设置播放器以始终按影片的原始大小绘制影片，从不进行缩放。指定 true，则强制影片缩放到播放器的 100%。
showmenu	true 或 false	指定 true，则启用整个上下文菜单项集合。指定 false，则使得除“关于 Flash Player”外的所有上下文菜单项变暗。
exec	应用程序的路径	在播放器内执行应用程序。
trapallkeys	true 或 false	指定 true，则将所有按键事件（包括快捷键事件）发送到 Flash Player 中的 onClipEvent(keyDown/keyUp) 处理函数。

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

在 Web 浏览器中，fscommand 动作在包含 Flash 影片的 HTML 页中调用 JavaScript 函数 moviename_DoFScommand。moviename 是 Flash Player 影片的名称，该名称由 EMBED 标签的 NAME 属性指定，或由 OBJECT 标签的 ID 属性指定。如果为 Flash Player 影片分配名称 myMovie，则调用的 JavaScript 函数为 myMovie_DoFScommand。

用法 3：fscommand 动作可将消息发送给 Macromedia Director，Lingo 将消息解释为字符串、事件或可执行的 Lingo 代码。如果该消息为字符串或事件，则必须编写 Lingo 代码以便从 fscommand 动作接收该消息，并在 Director 中执行动作。有关更多信息，请访问“Director 支持中心”(Director Support Center)。

用法 4：在 Visual Basic、Visual C++ 和可承载 ActiveX 控件的其他程序中，fscommand 利用可在环境的编程语言中处理的两个字符串发送 VB 事件。有关更多信息，请使用关键字 Flash method 搜索 Flash 支持中心 (Flash Support Center)。

示例

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

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

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

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

function myMovie_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 Web site!")

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

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